taking screenshots - new section for Documentation Guide (was installation guide)
Paul W. Frields
paul at frields.com
Mon Aug 30 22:11:21 UTC 2004
On Mon, 2004-08-30 at 17:40, Karsten Wade wrote:
> On Sat, 2004-08-28 at 05:25, Paul W. Frields wrote:
> > On Sat, 2004-08-28 at 06:30, Dave Pawson wrote:
> > > What processing tools Paul?
> > > And why is computeroutput necessary within screen? I'd have thought an
> > > either or was more reasonable for the processor to sort out?
>
> I am advocating:
>
> <screen>
> <![CDATA[
> foo {
> bar ()
> }
> ]]>
> </screen>
>
> Same for <programlisting/> blocks.
>
> This material, in the Fedora Doc Guide, is historical practice that we
> can (and should) revise.
>
> > I'm using the standard toolset and practices from the Documentation
> > Guide. Maybe that piece should be revisited in the Documentation Guide,
> > which indicates the proper syntax looks like this:
> >
> > <screen><userinput>cmd -i arg1</userinput>
> > <computeroutput>Uh-uh, you can't do that.</computeroutput></screen>
>
> That's not what I see on this page:
>
> http://fedora.redhat.com/participate/documentation-guide/s1-xml-tags-screen.html
You're right. I think I changed this in my usage because the extra
linefeeds were causing the PDF rendering to use WAY too much vertical
space. Would a bug report for that go against xmlto, then? And how does
your recommendation fare for those purposes?
--
Paul W. Frields, RHCE
More information about the fedora-docs-list
mailing list