mirror/stackexchange-dnscontrol
1
0
Fork 0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2024-05-11 05:55:12 +00:00
Code Issues Releases Activity

DOCS: Broken documentation URL's (#2839)

Browse Source
This commit is contained in:
Jeffrey Cafferata
2024-02-15 14:53:46 +01:00
committed by GitHub
parent 17115b6b59
commit 998c32ec5c
13 changed files with 90 additions and 90 deletions
Download Patch File Download Diff File Expand all files Collapse all files

76
commands/types/dnscontrol.d.ts vendored
View File

@@ -1423,10 +1423,10 @@ declare function IP(ip: string): number;
* One must supply the `LOC()` js helper all parameters. If that seems like too * One must supply the `LOC()` js helper all parameters. If that seems like too
* much work, see also helper functions: * much work, see also helper functions:
* *
* * [`LOC_BUILDER_DD({})`](../record/LOC_BUILDER_DD.md) - build a `LOC` by supplying only **d**ecimal **d**egrees. * * [`LOC_BUILDER_DD({})`](LOC_BUILDER_DD.md) - build a `LOC` by supplying only **d**ecimal **d**egrees.
* * [`LOC_BUILDER_DMS_STR({})`](../record/LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E * * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
* * [`LOC_BUILDER_DMM_STR({})`](../record/LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E * * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
* * [`LOC_BUILDER_STR({})`](../record/LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works * * [`LOC_BUILDER_STR({})`](LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works
* *
* ## Format ## * ## Format ##
* *
@@ -1466,9 +1466,9 @@ declare function LOC(deg1: number, min1: number, sec1: number, deg2: number, min
* - alt (float32, optional) * - alt (float32, optional)
* - ttl (optional) * - ttl (optional)
* *
* A helper to build [`LOC`](../domain/LOC.md) records. Supply four parameters instead of 12. * A helper to build [`LOC`](LOC.md) records. Supply four parameters instead of 12.
* *
* Internally assumes some defaults for [`LOC`](../domain/LOC.md) records. * Internally assumes some defaults for [`LOC`](LOC.md) records.
* *
* The cartesian coordinates are decimal degrees, like you typically find in e.g. Google Maps. * The cartesian coordinates are decimal degrees, like you typically find in e.g. Google Maps.
* *
@@ -1506,11 +1506,11 @@ declare function LOC(deg1: number, min1: number, sec1: number, deg2: number, min
* ``` * ```
* *
* Part of the series: * Part of the series:
* * [`LOC()`](../domain/LOC.md) - build a `LOC` by supplying all 12 parameters * * [`LOC()`](LOC.md) - build a `LOC` by supplying all 12 parameters
* * [`LOC_BUILDER_DD({})`](../record/LOC_BUILDER_DD.md) - accepts cartesian x, y * * [`LOC_BUILDER_DD({})`](LOC_BUILDER_DD.md) - accepts cartesian x, y
* * [`LOC_BUILDER_DMS_STR({})`](../record/LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E * * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
* * [`LOC_BUILDER_DMM_STR({})`](../record/LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E * * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
* * [`LOC_BUILDER_STR({})`](../record/LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works * * [`LOC_BUILDER_STR({})`](LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works
* *
* @see https://docs.dnscontrol.org/language-reference/domain-modifiers/loc_builder_dd * @see https://docs.dnscontrol.org/language-reference/domain-modifiers/loc_builder_dd
*/ */
@@ -1524,9 +1524,9 @@ declare function LOC_BUILDER_DD(opts: { label?: string; x: number; y: number; al
* - alt (float32, optional) * - alt (float32, optional)
* - ttl (optional) * - ttl (optional)
* *
* A helper to build [`LOC`](../domain/LOC.md) records. Supply three parameters instead of 12. * A helper to build [`LOC`](LOC.md) records. Supply three parameters instead of 12.
* *
* Internally assumes some defaults for [`LOC`](../domain/LOC.md) records. * Internally assumes some defaults for [`LOC`](LOC.md) records.
* *
* Accepts a string with decimal minutes (DMM) coordinates in the form: 25.24°S 153.15°E * Accepts a string with decimal minutes (DMM) coordinates in the form: 25.24°S 153.15°E
* *
@@ -1548,11 +1548,11 @@ declare function LOC_BUILDER_DD(opts: { label?: string; x: number; y: number; al
* ``` * ```
* *
* Part of the series: * Part of the series:
* * [`LOC()`](../domain/LOC.md) - build a `LOC` by supplying all 12 parameters * * [`LOC()`](LOC.md) - build a `LOC` by supplying all 12 parameters
* * [`LOC_BUILDER_DD({})`](../record/LOC_BUILDER_DD.md) - accepts cartesian x, y * * [`LOC_BUILDER_DD({})`](LOC_BUILDER_DD.md) - accepts cartesian x, y
* * [`LOC_BUILDER_DMS_STR({})`](../record/LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E * * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
* * [`LOC_BUILDER_DMM_STR({})`](../record/LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E * * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
* * [`LOC_BUILDER_STR({})`](../record/LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works * * [`LOC_BUILDER_STR({})`](LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works
* *
* @see https://docs.dnscontrol.org/language-reference/domain-modifiers/loc_builder_dmm_str * @see https://docs.dnscontrol.org/language-reference/domain-modifiers/loc_builder_dmm_str
*/ */
@@ -1566,9 +1566,9 @@ declare function LOC_BUILDER_DMM_STR(opts: { label?: string; str: string; alt?:
* - alt (float32, optional) * - alt (float32, optional)
* - ttl (optional) * - ttl (optional)
* *
* A helper to build [`LOC`](../domain/LOC.md) records. Supply three parameters instead of 12. * A helper to build [`LOC`](LOC.md) records. Supply three parameters instead of 12.
* *
* Internally assumes some defaults for [`LOC`](../domain/LOC.md) records. * Internally assumes some defaults for [`LOC`](LOC.md) records.
* *
* Accepts a string with degrees, minutes, and seconds (DMS) coordinates in the form: 41°24'12.2"N 2°10'26.5"E * Accepts a string with degrees, minutes, and seconds (DMS) coordinates in the form: 41°24'12.2"N 2°10'26.5"E
* *
@@ -1591,11 +1591,11 @@ declare function LOC_BUILDER_DMM_STR(opts: { label?: string; str: string; alt?:
* ``` * ```
* *
* Part of the series: * Part of the series:
* * [`LOC()`](../domain/LOC.md) - build a `LOC` by supplying all 12 parameters * * [`LOC()`](LOC.md) - build a `LOC` by supplying all 12 parameters
* * [`LOC_BUILDER_DD({})`](../record/LOC_BUILDER_DD.md) - accepts cartesian x, y * * [`LOC_BUILDER_DD({})`](LOC_BUILDER_DD.md) - accepts cartesian x, y
* * [`LOC_BUILDER_DMS_STR({})`](../record/LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E * * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
* * [`LOC_BUILDER_DMM_STR({})`](../record/LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E * * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
* * [`LOC_BUILDER_STR({})`](../record/LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works * * [`LOC_BUILDER_STR({})`](LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works
* *
* @see https://docs.dnscontrol.org/language-reference/domain-modifiers/loc_builder_dms_str * @see https://docs.dnscontrol.org/language-reference/domain-modifiers/loc_builder_dms_str
*/ */
@@ -1609,13 +1609,13 @@ declare function LOC_BUILDER_DMS_STR(opts: { label?: string; str: string; alt?:
* - alt (float32, optional) * - alt (float32, optional)
* - ttl (optional) * - ttl (optional)
* *
* A helper to build [`LOC`](../domain/LOC.md) records. Supply three parameters instead of 12. * A helper to build [`LOC`](LOC.md) records. Supply three parameters instead of 12.
* *
* Internally assumes some defaults for [`LOC`](../domain/LOC.md) records. * Internally assumes some defaults for [`LOC`](LOC.md) records.
* *
* Accepts a string and tries all `LOC_BUILDER_DM*_STR({})` methods: * Accepts a string and tries all `LOC_BUILDER_DM*_STR({})` methods:
* * [`LOC_BUILDER_DMS_STR({})`](../record/LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E * * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
* * [`LOC_BUILDER_DMM_STR({})`](../record/LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E * * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
* *
* ```javascript * ```javascript
* D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER), * D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
@@ -1639,11 +1639,11 @@ declare function LOC_BUILDER_DMS_STR(opts: { label?: string; str: string; alt?:
* ``` * ```
* *
* Part of the series: * Part of the series:
* * [`LOC()`](../domain/LOC.md) - build a `LOC` by supplying all 12 parameters * * [`LOC()`](LOC.md) - build a `LOC` by supplying all 12 parameters
* * [`LOC_BUILDER_DD({})`](../record/LOC_BUILDER_DD.md) - accepts cartesian x, y * * [`LOC_BUILDER_DD({})`](LOC_BUILDER_DD.md) - accepts cartesian x, y
* * [`LOC_BUILDER_DMS_STR({})`](../record/LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E * * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
* * [`LOC_BUILDER_DMM_STR({})`](../record/LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E * * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
* * [`LOC_BUILDER_STR({})`](../record/LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works * * [`LOC_BUILDER_STR({})`](LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works
* *
* @see https://docs.dnscontrol.org/language-reference/domain-modifiers/loc_builder_str * @see https://docs.dnscontrol.org/language-reference/domain-modifiers/loc_builder_str
*/ */
@@ -1653,7 +1653,7 @@ declare function LOC_BUILDER_STR(opts: { label?: string; str: string; alt?: numb
* DNSControl offers a `M365_BUILDER` which can be used to simply set up Microsoft 365 for a domain in an opinionated way. * DNSControl offers a `M365_BUILDER` which can be used to simply set up Microsoft 365 for a domain in an opinionated way.
* *
* It defaults to a setup without support for legacy Skype for Business applications. * It defaults to a setup without support for legacy Skype for Business applications.
* It doesn't set up SPF or DMARC. See [`SPF_BUILDER`](/language-reference/record-modifiers/dmarc_builder) and [`DMARC_BUILDER`](/language-reference/record-modifiers/spf_builder). * It doesn't set up SPF or DMARC. See [`SPF_BUILDER`](SPF_BUILDER.md) and [`DMARC_BUILDER`](DMARC_BUILDER.md).
* *
* ## Example * ## Example
* *
@@ -2031,7 +2031,7 @@ declare function NAPTR(subdomain: string, order: number, preference: number, ter
* By setting `NO_PURGE` on a domain, this tells DNSControl not to delete the * By setting `NO_PURGE` on a domain, this tells DNSControl not to delete the
* records found in the domain. * records found in the domain.
* *
* It is similar to [`IGNORE`](domain/IGNORE.md) but more general. * It is similar to [`IGNORE`](IGNORE.md) but more general.
* *
* The original reason for `NO_PURGE` was that a legacy system was adopting * The original reason for `NO_PURGE` was that a legacy system was adopting
* DNSControl. Previously the domain was managed via Microsoft DNS Server's GUI. * DNSControl. Previously the domain was managed via Microsoft DNS Server's GUI.
@@ -2067,8 +2067,8 @@ declare function NAPTR(subdomain: string, order: number, preference: number, ter
* *
* ## See also * ## See also
* *
* * [`PURGE`](domain/PURGE.md) is the default, thus this command is a no-op * * [`PURGE`](PURGE.md) is the default, thus this command is a no-op
* * [`IGNORE`](domain/IGNORE.md) is similar to `NO_PURGE` but is more selective * * [`IGNORE`](IGNORE.md) is similar to `NO_PURGE` but is more selective
* *
* @see https://docs.dnscontrol.org/language-reference/domain-modifiers/no_purge * @see https://docs.dnscontrol.org/language-reference/domain-modifiers/no_purge
*/ */

4
documentation/adding-new-rtypes.md
View File

@@ -322,9 +322,9 @@ Add the new file `FOO.md` to the documentation table of contents [`documentation
... ...
* Record Modifiers * Record Modifiers
... ...
* [DMARC_BUILDER](functions/record/DMARC_BUILDER.md) * [DMARC_BUILDER](functions/domain/DMARC_BUILDER.md)
+ * [FOO_HELPER](functions/record/FOO_HELPER.md) + * [FOO_HELPER](functions/record/FOO_HELPER.md)
* [SPF_BUILDER](functions/record/SPF_BUILDER.md) * [SPF_BUILDER](functions/domain/SPF_BUILDER.md)
... ...
``` ```
{% endcode %} {% endcode %}

10
documentation/code-tricks.md
View File

@@ -4,10 +4,10 @@ Problem: It is difficult to get CAA and other records exactly right.
Solution: Use a "builder" to construct it for you. Solution: Use a "builder" to construct it for you.
* [CAA Builder](functions/record/CAA_BUILDER.md) * [CAA Builder](functions/domain/CAA_BUILDER.md)
* [DMARC Builder](functions/record/DMARC_BUILDER.md) * [DMARC Builder](functions/domain/DMARC_BUILDER.md)
* [M365_BUILDER](functions/record/M365_BUILDER.md) * [M365_BUILDER](functions/domain/M365_BUILDER.md)
* [SPF Optimizer](functions/record/SPF_BUILDER.md) * [SPF Optimizer](functions/domain/SPF_BUILDER.md)
# Repeat records in many domains (macros) # Repeat records in many domains (macros)
@@ -157,5 +157,5 @@ domain exists, who requested it, any associated ticket numbers, and so
on. on.
We also comment the individual parts of a record. Look at the [SPF We also comment the individual parts of a record. Look at the [SPF
Optimizer](functions/record/SPF_BUILDER.md) example. Each part of Optimizer](functions/domain/SPF_BUILDER.md) example. Each part of
the SPF record has a comment. the SPF record has a comment.

8
documentation/functions/domain/LOC.md
View File

@@ -86,10 +86,10 @@ the LOC record type will supply defaults where values were absent on DNS import.
One must supply the `LOC()` js helper all parameters. If that seems like too One must supply the `LOC()` js helper all parameters. If that seems like too
much work, see also helper functions: much work, see also helper functions:
* [`LOC_BUILDER_DD({})`](../record/LOC_BUILDER_DD.md) - build a `LOC` by supplying only **d**ecimal **d**egrees. * [`LOC_BUILDER_DD({})`](LOC_BUILDER_DD.md) - build a `LOC` by supplying only **d**ecimal **d**egrees.
* [`LOC_BUILDER_DMS_STR({})`](../record/LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
* [`LOC_BUILDER_DMM_STR({})`](../record/LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
* [`LOC_BUILDER_STR({})`](../record/LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works * [`LOC_BUILDER_STR({})`](LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works
## Format ## ## Format ##

14
documentation/functions/domain/LOC_BUILDER_DD.md
View File

@@ -23,9 +23,9 @@ parameter_types:
- alt (float32, optional) - alt (float32, optional)
- ttl (optional) - ttl (optional)
A helper to build [`LOC`](../domain/LOC.md) records. Supply four parameters instead of 12. A helper to build [`LOC`](LOC.md) records. Supply four parameters instead of 12.
Internally assumes some defaults for [`LOC`](../domain/LOC.md) records. Internally assumes some defaults for [`LOC`](LOC.md) records.
The cartesian coordinates are decimal degrees, like you typically find in e.g. Google Maps. The cartesian coordinates are decimal degrees, like you typically find in e.g. Google Maps.
@@ -68,8 +68,8 @@ D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
Part of the series: Part of the series:
* [`LOC()`](../domain/LOC.md) - build a `LOC` by supplying all 12 parameters * [`LOC()`](LOC.md) - build a `LOC` by supplying all 12 parameters
* [`LOC_BUILDER_DD({})`](../record/LOC_BUILDER_DD.md) - accepts cartesian x, y * [`LOC_BUILDER_DD({})`](LOC_BUILDER_DD.md) - accepts cartesian x, y
* [`LOC_BUILDER_DMS_STR({})`](../record/LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
* [`LOC_BUILDER_DMM_STR({})`](../record/LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
* [`LOC_BUILDER_STR({})`](../record/LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works * [`LOC_BUILDER_STR({})`](LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works

14
documentation/functions/domain/LOC_BUILDER_DMM_STR.md
View File

@@ -20,9 +20,9 @@ parameter_types:
- alt (float32, optional) - alt (float32, optional)
- ttl (optional) - ttl (optional)
A helper to build [`LOC`](../domain/LOC.md) records. Supply three parameters instead of 12. A helper to build [`LOC`](LOC.md) records. Supply three parameters instead of 12.
Internally assumes some defaults for [`LOC`](../domain/LOC.md) records. Internally assumes some defaults for [`LOC`](LOC.md) records.
Accepts a string with decimal minutes (DMM) coordinates in the form: 25.24°S 153.15°E Accepts a string with decimal minutes (DMM) coordinates in the form: 25.24°S 153.15°E
@@ -48,8 +48,8 @@ D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
Part of the series: Part of the series:
* [`LOC()`](../domain/LOC.md) - build a `LOC` by supplying all 12 parameters * [`LOC()`](LOC.md) - build a `LOC` by supplying all 12 parameters
* [`LOC_BUILDER_DD({})`](../record/LOC_BUILDER_DD.md) - accepts cartesian x, y * [`LOC_BUILDER_DD({})`](LOC_BUILDER_DD.md) - accepts cartesian x, y
* [`LOC_BUILDER_DMS_STR({})`](../record/LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
* [`LOC_BUILDER_DMM_STR({})`](../record/LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
* [`LOC_BUILDER_STR({})`](../record/LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works * [`LOC_BUILDER_STR({})`](LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works

14
documentation/functions/domain/LOC_BUILDER_DMS_STR.md
View File

@@ -20,9 +20,9 @@ parameter_types:
- alt (float32, optional) - alt (float32, optional)
- ttl (optional) - ttl (optional)
A helper to build [`LOC`](../domain/LOC.md) records. Supply three parameters instead of 12. A helper to build [`LOC`](LOC.md) records. Supply three parameters instead of 12.
Internally assumes some defaults for [`LOC`](../domain/LOC.md) records. Internally assumes some defaults for [`LOC`](LOC.md) records.
Accepts a string with degrees, minutes, and seconds (DMS) coordinates in the form: 41°24'12.2"N 2°10'26.5"E Accepts a string with degrees, minutes, and seconds (DMS) coordinates in the form: 41°24'12.2"N 2°10'26.5"E
@@ -49,8 +49,8 @@ D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
Part of the series: Part of the series:
* [`LOC()`](../domain/LOC.md) - build a `LOC` by supplying all 12 parameters * [`LOC()`](LOC.md) - build a `LOC` by supplying all 12 parameters
* [`LOC_BUILDER_DD({})`](../record/LOC_BUILDER_DD.md) - accepts cartesian x, y * [`LOC_BUILDER_DD({})`](LOC_BUILDER_DD.md) - accepts cartesian x, y
* [`LOC_BUILDER_DMS_STR({})`](../record/LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
* [`LOC_BUILDER_DMM_STR({})`](../record/LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
* [`LOC_BUILDER_STR({})`](../record/LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works * [`LOC_BUILDER_STR({})`](LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works

18
documentation/functions/domain/LOC_BUILDER_STR.md
View File

@@ -20,14 +20,14 @@ parameter_types:
- alt (float32, optional) - alt (float32, optional)
- ttl (optional) - ttl (optional)
A helper to build [`LOC`](../domain/LOC.md) records. Supply three parameters instead of 12. A helper to build [`LOC`](LOC.md) records. Supply three parameters instead of 12.
Internally assumes some defaults for [`LOC`](../domain/LOC.md) records. Internally assumes some defaults for [`LOC`](LOC.md) records.
Accepts a string and tries all `LOC_BUILDER_DM*_STR({})` methods: Accepts a string and tries all `LOC_BUILDER_DM*_STR({})` methods:
* [`LOC_BUILDER_DMS_STR({})`](../record/LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
* [`LOC_BUILDER_DMM_STR({})`](../record/LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
{% code title="dnsconfig.js" %} {% code title="dnsconfig.js" %}
@@ -55,8 +55,8 @@ D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
Part of the series: Part of the series:
* [`LOC()`](../domain/LOC.md) - build a `LOC` by supplying all 12 parameters * [`LOC()`](LOC.md) - build a `LOC` by supplying all 12 parameters
* [`LOC_BUILDER_DD({})`](../record/LOC_BUILDER_DD.md) - accepts cartesian x, y * [`LOC_BUILDER_DD({})`](LOC_BUILDER_DD.md) - accepts cartesian x, y
* [`LOC_BUILDER_DMS_STR({})`](../record/LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
* [`LOC_BUILDER_DMM_STR({})`](../record/LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
* [`LOC_BUILDER_STR({})`](../record/LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works * [`LOC_BUILDER_STR({})`](LOC_BUILDER_STR.md) - tries the cooordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works

2
documentation/functions/domain/M365_BUILDER.md
View File

@@ -24,7 +24,7 @@ parameter_types:
DNSControl offers a `M365_BUILDER` which can be used to simply set up Microsoft 365 for a domain in an opinionated way. DNSControl offers a `M365_BUILDER` which can be used to simply set up Microsoft 365 for a domain in an opinionated way.
It defaults to a setup without support for legacy Skype for Business applications. It defaults to a setup without support for legacy Skype for Business applications.
It doesn't set up SPF or DMARC. See [`SPF_BUILDER`](/language-reference/record-modifiers/dmarc_builder) and [`DMARC_BUILDER`](/language-reference/record-modifiers/spf_builder). It doesn't set up SPF or DMARC. See [`SPF_BUILDER`](SPF_BUILDER.md) and [`DMARC_BUILDER`](DMARC_BUILDER.md).
## Example ## Example

6
documentation/functions/domain/NO_PURGE.md
View File

@@ -12,7 +12,7 @@ other system.
By setting `NO_PURGE` on a domain, this tells DNSControl not to delete the By setting `NO_PURGE` on a domain, this tells DNSControl not to delete the
records found in the domain. records found in the domain.
It is similar to [`IGNORE`](domain/IGNORE.md) but more general. It is similar to [`IGNORE`](IGNORE.md) but more general.
The original reason for `NO_PURGE` was that a legacy system was adopting The original reason for `NO_PURGE` was that a legacy system was adopting
DNSControl. Previously the domain was managed via Microsoft DNS Server's GUI. DNSControl. Previously the domain was managed via Microsoft DNS Server's GUI.
@@ -50,5 +50,5 @@ With introduction of `diff2` algorithm (enabled by default in v4.0.0),
## See also ## See also
* [`PURGE`](domain/PURGE.md) is the default, thus this command is a no-op * [`PURGE`](PURGE.md) is the default, thus this command is a no-op
* [`IGNORE`](domain/IGNORE.md) is similar to `NO_PURGE` but is more selective * [`IGNORE`](IGNORE.md) is similar to `NO_PURGE` but is more selective

2
documentation/index.md
View File

@@ -18,7 +18,7 @@ Take advantage of the advanced features. Use macros and variables for easier upd
* Supports 35+ [DNS Providers](providers.md) including [BIND](providers/bind.md), [AWS Route 53](providers/route53.md), [Google DNS](providers/gcloud.md), and [name.com](providers/namedotcom.md). * Supports 35+ [DNS Providers](providers.md) including [BIND](providers/bind.md), [AWS Route 53](providers/route53.md), [Google DNS](providers/gcloud.md), and [name.com](providers/namedotcom.md).
* [Apply CI/CD principles](ci-cd-gitlab.md) to DNS: Unit-tests, system-tests, automated deployment. * [Apply CI/CD principles](ci-cd-gitlab.md) to DNS: Unit-tests, system-tests, automated deployment.
* All the benefits of Git (or any VCS) for your DNS zone data. View history. Accept PRs. * All the benefits of Git (or any VCS) for your DNS zone data. View history. Accept PRs.
* Optimize DNS with [SPF optimizer](functions/record/SPF_BUILDER.md). Detect too many lookups. Flatten includes. * Optimize DNS with [SPF optimizer](functions/domain/SPF_BUILDER.md). Detect too many lookups. Flatten includes.
* Runs on Linux, Windows, Mac, or any operating system supported by Go. * Runs on Linux, Windows, Mac, or any operating system supported by Go.
* Enable/disable Cloudflare proxying (the "orange cloud" button) directly from your DNSControl files. * Enable/disable Cloudflare proxying (the "orange cloud" button) directly from your DNSControl files.
* [Assign an IP address to a constant](examples.md#variables-for-common-ip-addresses) and use the variable name throughout the configuration. Need to change the IP address globally? Just change the variable and "recompile". * [Assign an IP address to a constant](examples.md#variables-for-common-ip-addresses) and use the variable name throughout the configuration. Need to change the IP address globally? Just change the variable and "recompile".

2
documentation/providers.md
View File

@@ -187,5 +187,5 @@ DNSControl tries to make writing a provider as easy as possible. DNSControl
does most of the work for you, you only have to write code to authenticate, does most of the work for you, you only have to write code to authenticate,
download DNS records, and perform create/modify/delete operations on those download DNS records, and perform create/modify/delete operations on those
records. Please read the directions for [Writing new DNS records. Please read the directions for [Writing new DNS
providers](/developer-info/writing-providers). The DNS maintainers will gladly providers](writing-providers.md). The DNS maintainers will gladly
coach you through the process. coach you through the process.

2
documentation/styleguide-doc.md
View File

@@ -207,7 +207,7 @@ The function `GetRegistrarCorrections()` returns...
#### Internal links #### Internal links
```markdown ```markdown
Blah blah blah [M365_BUILDER](functions/record/M365_BUILDER.md) Blah blah blah [M365_BUILDER](functions/domain/M365_BUILDER.md)
``` ```
{% hint style="info" %} {% hint style="info" %}