← Back to team overview

openstack-doc-core team mailing list archive

Re: conventions for docbook element usage

 

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

>> 1) "Information or configuration files that the user has to type
>> or read"
>> 
>> This uses <literallayout>.  I would propose using
>> <programlisting>.
> 
> That's fine by me, though it'll take a while to change them all.

We could make the change programmatically, either with an xslt or in
this case even with find-and-replace-in-files in Oxygen.

>> 6) "File names"
>> 
>> Instead of <literallayout>, <filename>
>> 
> Okay. When we do this the output may not yet do anything to
> indicate it is marked up but we'll need to find out.

<filename> is currently formatted as monospace.

David
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJPU6ugAAoJEMHeSXG7afUh7MYH/1IeEAtBEM4AoMdeolrTGoEK
Ta+K2uQOgOBqNqhzyWjCAlozzmz3Z6C7tGllMJPxHD1NOJjpVubinSXwLQZVOetC
cgsBBbZkMeLxic/zRWlVdFhiGED9FkAEhzHL6ek6AfVmKO+fI8/DT0BnILRRrQww
4Z0FnZv4rP2J5I8TeCixDnC9kqCOQRcJni/JD3jeJIBAgeZ6F9XzeKYk+0EkaKa+
nHUFW3LRAxRRLF88y81MsB/z+XoGu5ATn4asprHWoatLNRZFXbTVmpe4i988Lrp2
3TMjbayuK/rWUmfDSEPw37DKpCDRSYbP6bjW6OpDDs0ySYoYzymoWDVdi2B0nIc=
=jkTb
-----END PGP SIGNATURE-----


Follow ups

References