Guy Dalziel wrote these words on 08/05/09 10:53 CST: > In a recent discussion it was debated whether or not there is any real > difference between option and parameter. Parameter places a slight > emphasis on the parameter, while option does not. Docbook states > (http://docbook.org/tdg/en/html/option.html) that "Options may or may > not be required.", "The optional element can be used to explicitly > identify options that are not required." Using optional places the > parameter within brackets [--this-option]: and makes it much clearer > that the parameter is optional. > I propose that we start using optional for optional parameters as it is > clearer and is in accordance with docbook.
I would probably be against this as the brackets might throw some folks off by thinking they need them. Additionally, because we've set a standard and been using it for many years, I suggest we maintain status quo. -- Randy rmlscsi: [bogomips 1003.25] [GNU ld version 2.16.1] [gcc (GCC) 4.0.3] [GNU C Library stable release version 2.3.6] [Linux 2.6.14.3 i686] 11:45:00 up 30 days, 13 min, 1 user, load average: 0.41, 0.28, 0.16 -- http://linuxfromscratch.org/mailman/listinfo/blfs-dev FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
