You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs-cvs@perl.apache.org by th...@apache.org on 2004/08/26 04:10:17 UTC
cvs commit: modperl-docs/src/contribute/docs style.pod
theory 2004/08/25 19:10:17
Modified: src/contribute/docs style.pod
Log:
Difference between F<>, I<>, and B<>.
Revision Changes Path
1.5 +12 -5 modperl-docs/src/contribute/docs/style.pod
Index: style.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/contribute/docs/style.pod,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- style.pod 18 Jun 2002 08:44:11 -0000 1.4
+++ style.pod 26 Aug 2004 02:10:17 -0000 1.5
@@ -114,14 +114,21 @@
=item *
-Use IE<lt>filenameE<gt> for filenames, URIs and things that are
-generally written in italics.
+Use FE<lt>filenameE<gt> for filenames, directories/paths, URIs, and
+the like.
=item *
-Use BE<lt>stressE<gt> for stressing things, but you should avoid using
-this tag unless you think things are very important. Over-use of the
-bold text reduces it's original intention -- make things stand out.
+Use IE<lt>italicsE<gt> for emphasizing things. But use them with care,
+when things I<really> need to be emphasized.
+
+=item *
+
+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 *
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org