[134981] trunk/base/doc
cal at macports.org
cal at macports.org
Sun Apr 12 13:24:02 PDT 2015
Revision: 134981
https://trac.macports.org/changeset/134981
Author: cal at macports.org
Date: 2015-04-12 13:24:01 -0700 (Sun, 12 Apr 2015)
Log Message:
-----------
base/doc: actually use proper EBNF in config file grammar, add note on comments and empty lines in sources.conf
Modified Paths:
--------------
trunk/base/doc/sources.conf.5.txt
trunk/base/doc/variants.conf.5.txt
Modified: trunk/base/doc/sources.conf.5.txt
===================================================================
--- trunk/base/doc/sources.conf.5.txt 2015-04-12 20:18:51 UTC (rev 134980)
+++ trunk/base/doc/sources.conf.5.txt 2015-04-12 20:24:01 UTC (rev 134981)
@@ -11,13 +11,14 @@
-----------
*sources.conf* is the configuration file used by the MacPorts system to locate
its port definitions. The file is read by the *port* command to find available
-ports and how to install them. Entries in this file are URIs optionally followed
-by flags in square brackets. Each source specification is given on a separate
-line. A grammar in EBNF is given below:
+ports and how to install them. Lines beginning with '#' are comments, empty
+lines are ignored. Entries in this file are URIs optionally followed by flags in
+square brackets. Each source specification is given on a separate line.
+A grammar in EBNF is given below:
--------
-<line> ::= <URI> [ '[' <flags> ']' ]
-<flags> ::= <flag> [ ',' [ ' ' | '\t' ] <flags> ]
-<flag> ::= 'default' | 'nosync'
+line = URI, [ '[', flag, { space, flag }, ']' ] ;
+flag = 'default' | 'nosync' ;
+space = ' ' | '\t' ;
--------
URI FORMATS
Modified: trunk/base/doc/variants.conf.5.txt
===================================================================
--- trunk/base/doc/variants.conf.5.txt 2015-04-12 20:18:51 UTC (rev 134980)
+++ trunk/base/doc/variants.conf.5.txt 2015-04-12 20:24:01 UTC (rev 134981)
@@ -21,9 +21,9 @@
tab-delimited list of zero or more variants, where each variant is either
explicitly enabled or disabled using a leading '+' or '-'. In EBNF:
----
-line = variant, { space, variant }
-space = ' ' | '\t'
-variant = ( '+' | '-' ), name
+line = variant, { space, variant } ;
+space = ' ' | '\t' ;
+variant = ( '+' | '-' ), name ;
----
where 'name' is the name of the variant. Variants that are not provided by
a port (or no port at all) are silently ignored.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.macosforge.org/pipermail/macports-changes/attachments/20150412/044ee1d7/attachment.html>
More information about the macports-changes
mailing list