Skip to content

Commit e0ad062

Browse files
committed
Documentation: Added remarks for ModConfig
1 parent c4d27e6 commit e0ad062

9 files changed

+20
-6
lines changed

Documentation/ModConfig.TSerialize...ctor.ZKsea+H43MefB36oOBiG5g.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
#### [KeepCoding](index.md 'index')
22
### [KeepCoding](KeepCoding.md 'KeepCoding').[ModConfig<TSerialize>](ModConfig.TSerialize..md 'KeepCoding.ModConfig<TSerialize>')
33
## ModConfig<TSerialize>.ModConfig(string) Constructor
4-
Creates a new [ModConfig<TSerialize>](ModConfig.TSerialize..md 'KeepCoding.ModConfig<TSerialize>') with the target file name and an optional event of when the file is read.
4+
Creates a new [ModConfig<TSerialize>](ModConfig.TSerialize..md 'KeepCoding.ModConfig<TSerialize>') with the target file name and an optional event of when the file is read. A file will automatically be made if it doesn't exist. A JSON property defined in the type [TSerialize](ModConfig.TSerialize..md#KeepCoding.ModConfig.TSerialize..TSerialize 'KeepCoding.ModConfig<TSerialize>.TSerialize') that isn't in the file will automatically write to the file with said property.
55
```csharp
66
public ModConfig(string fileName);
77
```
@@ -12,3 +12,5 @@ The file name to get.
1212

1313
#### Exceptions
1414
[ConstructorArgumentException](ConstructorArgumentException.md 'KeepCoding.Internal.ConstructorArgumentException')
15+
### Remarks
16+
In the editor, the constructor will not merge the default values of the type with the file.

Documentation/ModConfig.TSerialize..HasReadSucceeded.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
#### [KeepCoding](index.md 'index')
22
### [KeepCoding](KeepCoding.md 'KeepCoding').[ModConfig<TSerialize>](ModConfig.TSerialize..md 'KeepCoding.ModConfig<TSerialize>')
33
## ModConfig<TSerialize>.HasReadSucceeded Property
4-
Whether or not there has been a successful read of the settings file.
4+
Whether or not there has been a successful read of the settings file. This value will always be false in the editor.
55
```csharp
66
public bool HasReadSucceeded { get; set; }
77
```

Documentation/ModConfig.TSerialize..Merge.ztIxpEjvzLjYtgSKoVEuHQ.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,3 +16,5 @@ Determines whether it should remove values from the original file that isn't con
1616

1717
#### Exceptions
1818
[System.NullReferenceException](https://docs.microsoft.com/en-us/dotnet/api/System.NullReferenceException 'System.NullReferenceException')
19+
### Remarks
20+
In the editor, this method does nothing.
Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
11
#### [KeepCoding](index.md 'index')
22
### [KeepCoding](KeepCoding.md 'KeepCoding').[ModConfig<TSerialize>](ModConfig.TSerialize..md 'KeepCoding.ModConfig<TSerialize>')
33
## ModConfig<TSerialize>.ModConfig() Constructor
4-
Creates a new [ModConfig<TSerialize>](ModConfig.TSerialize..md 'KeepCoding.ModConfig<TSerialize>') with the target file name and an optional event of when the file is read.
4+
Creates a new [ModConfig<TSerialize>](ModConfig.TSerialize..md 'KeepCoding.ModConfig<TSerialize>') with the target file name and an optional event of when the file is read. A file will automatically be made if it doesn't exist. A JSON property defined in the type [TSerialize](ModConfig.TSerialize..md#KeepCoding.ModConfig.TSerialize..TSerialize 'KeepCoding.ModConfig<TSerialize>.TSerialize') that isn't in the file will automatically write to the file with said property.
55
```csharp
66
public ModConfig();
77
```
88
#### Exceptions
99
[ConstructorArgumentException](ConstructorArgumentException.md 'KeepCoding.Internal.ConstructorArgumentException')
10+
### Remarks
11+
In the editor, the constructor will not merge the default values of the type with the file.

Documentation/ModConfig.TSerialize..Read().md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,3 +7,5 @@ public TSerialize Read();
77
```
88
#### Returns
99
[TSerialize](ModConfig.TSerialize..md#KeepCoding.ModConfig.TSerialize..TSerialize 'KeepCoding.ModConfig<TSerialize>.TSerialize')
10+
### Remarks
11+
In the editor, this method returns the default value of the constructor in [TSerialize](ModConfig.TSerialize..md#KeepCoding.ModConfig.TSerialize..TSerialize 'KeepCoding.ModConfig<TSerialize>.TSerialize').

Documentation/ModConfig.TSerialize..ToString().md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,3 +8,5 @@ public override string ToString();
88
#### Returns
99
[System.String](https://docs.microsoft.com/en-us/dotnet/api/System.String 'System.String')
1010
A string representation of the value from [Read()](ModConfig.TSerialize..Read().md 'KeepCoding.ModConfig<TSerialize>.Read()').
11+
### Remarks
12+
In the editor, this method serializes the default value of the constructor in [TSerialize](ModConfig.TSerialize..md#KeepCoding.ModConfig.TSerialize..TSerialize 'KeepCoding.ModConfig<TSerialize>.TSerialize').

Documentation/ModConfig.TSerialize..Write.BW1ArfhzLuv73fcInRzVFA.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,3 +12,5 @@ The value to overwrite the settings file with.
1212

1313
#### Exceptions
1414
[System.NullReferenceException](https://docs.microsoft.com/en-us/dotnet/api/System.NullReferenceException 'System.NullReferenceException')
15+
### Remarks
16+
In the editor, this method does nothing.

Documentation/ModConfig.TSerialize..Write.JCanpm.fnSPX3sNGJXtQxg.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,3 +12,5 @@ The contents to write.
1212

1313
#### Exceptions
1414
[NullIteratorException](NullIteratorException.md 'KeepCoding.Internal.NullIteratorException')
15+
### Remarks
16+
In the editor, this method does nothing.

Documentation/ModConfig.TSerialize..md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,12 +24,12 @@ Implements [ILog](ILog.md 'KeepCoding.ILog')
2424
2525
| Constructors | |
2626
| :--- | :--- |
27-
| [ModConfig()](ModConfig.TSerialize..ModConfig().md 'KeepCoding.ModConfig&lt;TSerialize&gt;.ModConfig()') | Creates a new [ModConfig&lt;TSerialize&gt;](ModConfig.TSerialize..md 'KeepCoding.ModConfig&lt;TSerialize&gt;') with the target file name and an optional event of when the file is read.<br/> |
28-
| [ModConfig(string)](ModConfig.TSerialize...ctor.ZKsea+H43MefB36oOBiG5g.md 'KeepCoding.ModConfig&lt;TSerialize&gt;.ModConfig(string)') | Creates a new [ModConfig&lt;TSerialize&gt;](ModConfig.TSerialize..md 'KeepCoding.ModConfig&lt;TSerialize&gt;') with the target file name and an optional event of when the file is read.<br/> |
27+
| [ModConfig()](ModConfig.TSerialize..ModConfig().md 'KeepCoding.ModConfig&lt;TSerialize&gt;.ModConfig()') | Creates a new [ModConfig&lt;TSerialize&gt;](ModConfig.TSerialize..md 'KeepCoding.ModConfig&lt;TSerialize&gt;') with the target file name and an optional event of when the file is read. A file will automatically be made if it doesn't exist. A JSON property defined in the type [TSerialize](ModConfig.TSerialize..md#KeepCoding.ModConfig.TSerialize..TSerialize 'KeepCoding.ModConfig&lt;TSerialize&gt;.TSerialize') that isn't in the file will automatically write to the file with said property.<br/> |
28+
| [ModConfig(string)](ModConfig.TSerialize...ctor.ZKsea+H43MefB36oOBiG5g.md 'KeepCoding.ModConfig&lt;TSerialize&gt;.ModConfig(string)') | Creates a new [ModConfig&lt;TSerialize&gt;](ModConfig.TSerialize..md 'KeepCoding.ModConfig&lt;TSerialize&gt;') with the target file name and an optional event of when the file is read. A file will automatically be made if it doesn't exist. A JSON property defined in the type [TSerialize](ModConfig.TSerialize..md#KeepCoding.ModConfig.TSerialize..TSerialize 'KeepCoding.ModConfig&lt;TSerialize&gt;.TSerialize') that isn't in the file will automatically write to the file with said property.<br/> |
2929

3030
| Properties | |
3131
| :--- | :--- |
32-
| [HasReadSucceeded](ModConfig.TSerialize..HasReadSucceeded.md 'KeepCoding.ModConfig&lt;TSerialize&gt;.HasReadSucceeded') | Whether or not there has been a successful read of the settings file.<br/> |
32+
| [HasReadSucceeded](ModConfig.TSerialize..HasReadSucceeded.md 'KeepCoding.ModConfig&lt;TSerialize&gt;.HasReadSucceeded') | Whether or not there has been a successful read of the settings file. This value will always be false in the editor.<br/> |
3333

3434
| Methods | |
3535
| :--- | :--- |

0 commit comments

Comments
 (0)