[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