[Fai-commit] r5928 - in trunk: debian man

[Michael Tautschnig]

Author: mt
Date: 2010-08-01 06:33:39 +0000 (Sun, 01 Aug 2010)
New Revision: 5928

Modified:
   trunk/debian/changelog
   trunk/man/setup-storage.8
Log:
Added sizespec non-terminal to grammer for nicer formatting as suggested by
Thomas


Modified: trunk/debian/changelog
===================================================================
--- trunk/debian/changelog	2010-08-01 04:03:26 UTC (rev 5927)
+++ trunk/debian/changelog	2010-08-01 06:33:39 UTC (rev 5928)
@@ -147,6 +147,8 @@
   * dhcp-edit, control: Updated to work with isc-dhcp-server or
     dhcp3-server, whichever is available.
   * fai-guide.txt: Updated to isc-dhcp-server.
+  * setup-storage.8: Nicer formatting of size specifications in grammar as
+    suggested by Thomas.
 
   [ Michael Prokop ]
   * subroutines, fai: make sure fai exits with the according return

Modified: trunk/man/setup-storage.8
===================================================================
--- trunk/man/setup-storage.8	2010-08-01 04:03:26 UTC (rev 5927)
+++ trunk/man/setup-storage.8	2010-08-01 06:33:39 UTC (rev 5928)
@@ -347,38 +347,39 @@
 .br
 
 
-size ::= (RAM:[[:digit:]]+%|[[:digit:]]+[kKMGTP%iB]*)(-(RAM:[[:digit:]]+%|[[:digit:]]+[kKMGTP%iB]*)?)?(:resize)?
+sizespec ::= RAM:[[:digit:]]+%|[[:digit:]]+[kKMGTP%iB]*
 .br
          /* size in kilo (KiB), mega (default, MiB), giga (GiB), tera (TiB),
 .br
-          * petabytes (PiB) or percentage of disk size or RAM size, possibly
-.br
-          * given as a range; physical partitions or lvm logical volumes only;
-.br
+          * petabytes (PiB) or percentage of disk size or RAM size;
+.br          
           * in future releases KB, MB, GB, ... will be treated as 1000 instead
 .br
           * of 1024 (KiB, MiB, GiB, ...) multipliers */
+
+
+size ::= <sizespec>(-(<sizespec>)?)?(:resize)?
 .br
-         | -(RAM:[[:digit:]]+%|[[:digit:]]+[kKMGTP%iB]*)(:resize)?
+         /* size, possibly given as a range; physical partitions or lvm logical
 .br
-         /* size in kilo, mega (default), giga, tera or petabytes or %,
+          * volumes only */
 .br
-          * given as upper limit; physical partitions
+         | -<sizespec>(:resize)?
 .br
-          * or lvm logical volumes only */
+         /* size given as upper limit; physical partitions or lvm logical
 .br
+          * volumes only */
+.br
          | [^,:[:space:]]+(:(spare|missing))*(,[^,:[:space:]]+(:(spare|missing))*)*
 .br
          /* devices and options for a raid or lvm vg */
 .br
 
 
-tmpfs_size ::= (RAM:[[:digit:]]+%|[[:digit:]]+[kKMGTPiB]*)
+tmpfs_size ::= <sizespec>
 .br
-         /* tmpfs size in percentage of the total RAM or fixed size in
+         /* tmpfs size */
 .br
-          kilo (KiB), mega (default, MiB), giga (GiB), tera (TiB) or petabytes (PiB).
-.br
 
 
 mount_options ::= [^[:space:]]+