perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: modperl-docs/src/docs conventions.pod
Date Thu, 26 Aug 2004 02:14:38 GMT
theory      2004/08/25 19:14:38

  Modified:    src/docs conventions.pod
  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 *
  +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:
For additional commands, e-mail:

View raw message