theory 2004/08/25 19:14:38 Modified: src/docs conventions.pod Log: More style. Revision Changes Path 1.2 +15 -5 modperl-docs/src/docs/conventions.pod Index: conventions.pod =================================================================== RCS file: /home/cvs/modperl-docs/src/docs/conventions.pod,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- conventions.pod 18 Jun 2002 08:39:53 -0000 1.1 +++ conventions.pod 26 Aug 2004 02:14:38 -0000 1.2 @@ -47,16 +47,26 @@ =item * -I<Italic> +Use FE<lt>filenameE<gt> for filenames, directories/paths, URIs, and +the like. -is used for file names or things you have to replace. +=item * + +Use IE<lt>italicsE<gt> for emphasizing things. But use them with care, +when things I<really> need to be emphasized. =item * -C<Constant width> +Use BE<lt>stressE<gt> for stressing things more strongly than +IE<lt>italicsE<gt> does. But avoid using this tag unless you think things +are B<very> important. Defer to IE<lt>italicsE<gt> for emphasis, instead. +Over-use of bold text reduces its original intention -- so use it +with care to really make things stand out when they need to stand out. + +=item * -is used for commands/program names, configuration items or Perl -code/function names, and manpage references. +Use CE<lt>Constant widthE<gt> for commands/program names, configuration +items or Perl code/function names, and manpage references. =item *
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
