Date: Sun, 23 May 2004 21:47:53 +0200 From: Martin Heinen <martin@sumuk.de> To: Mark Linimon <linimon@lonesome.com> Cc: freebsd-ports@freebsd.org Subject: Re: RFC: minor change to Porter's Handbook Message-ID: <20040523194753.GC29120@sumuk.de> In-Reply-To: <Pine.LNX.4.44.0405221355320.15322-100000@pancho> References: <Pine.LNX.4.44.0405221355320.15322-100000@pancho>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, May 22, 2004 at 01:57:13PM -0500, Mark Linimon wrote: > + <example id="dot-error-breaks-index"><title></title> > + <para>Assume that someone has the line > + <programlisting>USE_POINTYHAT=yes</programlisting> > + in <filename>make.conf</filename>. The first of > + the next two <filename>Makefile</filename> snippets will > + cause <command>make index</command> to fail, while the > + second one will not: > + <programlisting> > +.if USE_POINTYHAT > +.error "POINTYHAT is not supported" > +.endif > + </programlisting> > + <programlisting> > +.if USE_POINTYHAT > +IGNORE=POINTYHAT is not supported > +.endif > + </programlisting> > + </para> > + </example> As Simon already noted, white space is significant inside programlisting and content should immediately follow the opening tag. The programlisting element is a block element which should not be used inside other block elements. I replaced programlisting with literal in the running text, using an option element would be an option too :-) + <example id="dot-error-breaks-index"><title></title> + <para>Assume that someone has the line + <literal>USE_POINTYHAT=yes</literal> + in <filename>make.conf</filename>. The first of + the next two <filename>Makefile</filename> snippets will + cause <command>make index</command> to fail, while the + second one will not:</para> + + <programlisting>.if USE_POINTYHAT +.error "POINTYHAT is not supported" +.endif</programlisting> + + <programlisting>.if USE_POINTYHAT +IGNORE=POINTYHAT is not supported +.endif</programlisting> + </example> -- Marxpitn
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040523194753.GC29120>