Constants: Tables or Varlists?
| From: | Edward Z. Yang | Date: | Thu, 05 Apr 2007 16:48:52 +0000 |
| Subject: | Constants: Tables or Varlists? | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969376010@lists.php.net to get a copy of this message | ||
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
I was looking over some older documentation to get ideas on formatting
for docs I was writing, and something struck me: some of the constant
lists were written using <variablelist> (ref.array), while others were
written using <table> (ref.mysql).
Arguably, <table> is less semantic than <variablelist>, but I tend to
favor the compactness of a table (a single entry takes up one line,
rather than two). I'd like to know if there are any guidelines regarding
which to use. For the record, xml_proto.php writes <variablelist> style
constant lists by default.
Also, with a little bit of XSLT hacking, it would probably be possible
to turn <variablelist> into the table form.
- --
Edward Z. Yang Personal: edwardzyang@thewritingpot.com
SN:Ambush Commander Website: http://www.thewritingpot.com/
GPGKey:0x869C48DA http://www.thewritingpot.com/gpgpubkey.asc
3FA8 E9A9 7385 B691 A6FC B3CB A933 BE7D 869C 48DA
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (MingW32)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
iD8DBQFGFSh0qTO+fYacSNoRAnbmAJ9iBGZ3965vIE8HjsOu6mFNyqs1bwCdHLkQ
ZL5Ac8GmXJhs2FOw8ediRJQ=
=aIbo
-----END PGP SIGNATURE-----