Date: Wed, 10 Jul 2013 10:46:39 -0400 (EDT) From: Benjamin Kaduk <kaduk@MIT.EDU> To: Warren Block <wblock@freebsd.org> Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org Subject: Re: svn commit: r42235 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup Message-ID: <alpine.GSO.1.10.1307101045290.26275@multics.mit.edu> In-Reply-To: <201307101135.r6ABZl5q011350@svn.freebsd.org> References: <201307101135.r6ABZl5q011350@svn.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, 10 Jul 2013, Warren Block wrote: > Author: wblock > Date: Wed Jul 10 11:35:47 2013 > New Revision: 42235 > URL: http://svnweb.freebsd.org/changeset/doc/42235 > > Log: > Add a section showing use of <email> tags, both with and without > "nolink". Move the sample <procedure> inside the <example>, the > comment that noted procedures could not be inside examples is no > longer correct. > > Modified: > head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml > > Modified: head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Wed Jul 10 10:38:06 2013 (r42234) > +++ head/en_US.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml Wed Jul 10 11:35:47 2013 (r42235) > @@ -1572,6 +1570,49 @@ This is the file called 'foo2'</screen> > </example> > </sect2> > > + <sect2 id="docbook-markup-email-addresses"> > + <title>Email Addresses</title> > + > + <para>Email addresses are marked up with > + <sgmltag>email</sgmltag> tags. In the <acronym>HTML</acronym> > + output format, the wrapped text becomes a hyperlink to the > + email address. Other output formats that support hyperlinks > + may also make the email address into a link.</para> > + > + <example> > + <title><sgmltag>email</sgmltag> with a Hyperlink</title> > + > + <para>Usage:</para> > + > + <programlisting><sgmltag class="starttag">para</sgmltag>Questions about &os; may be sent to > + <sgmltag class="starttag">email</sgmltag>questions@&os;.org<sgmltag class="endtag">email</sgmltag>.<sgmltag class="endtag">para</sgmltag></programlisting> Somehow I thought "freebsd-questions@FreeBSD.org" was the preferred spelling. > + <para>Appearance:</para> > + > + <para>Questions about &os; may be sent to > + <email>questions@&os;.org</email>.</para> > + </example> > + <para>A &os;-specific extension allows setting the > + <literal>role</literal> attribute to <literal>nolink</literal> > + to prevent the creation of the hyperlink to the email > + address.</para> > + > + <example> > + <title><sgmltag>email</sgmltag> Without a Hyperlink</title> > + > + <para>Usage:</para> > + > + <programlisting><sgmltag class="starttag">para</sgmltag>Questions about &os; may be sent to > + <sgmltag class="starttag">email role="nolink"</sgmltag>questions@&os;.org<sgmltag class="endtag">email</sgmltag>.<sgmltag class="endtag">para</sgmltag></programlisting> > + > + <para>Appearance:</para> > + > + <para>Questions about &os; may be sent to > + <email role="nolink">questions@&os;.org</email>.</para> > + </example> > + </sect2> (all four places, of course) -Ben > <sect2 id="docbook-markup-describing-makefiles"> > <title>Describing <filename>Makefile</filename>s</title> > > _______________________________________________ > svn-doc-all@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/svn-doc-all > To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org" >
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.GSO.1.10.1307101045290.26275>