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 docs mailing list