perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From the...@apache.org
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
  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: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org


Mime
View raw message