Terminal output

classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|

Terminal output

Thomas R. Jones-2
What is the recommended format of terminal output?

I expect that <command></command><computeroutput></computeroutput> but
want to be in compliance with other authors.

Also, its been awhile since I wrote with novdoc; what
wrapping/hyphenation directives are available to authors? I've got
output that is 100-105 columns wide. Looks ugly on the pdf....simply
concatenates.

Thanks for your time.
--
Thomas R. Jones <[hidden email]>


signature.asc (237 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: Terminal output

Frank Sundermeyer
On Thu, 17 May 2012 16:31:31 -0500 Thomas R. Jones wrote:

Hi,

> What is the recommended format of terminal output?
>
> I expect that <command></command><computeroutput></computeroutput> but
> want to be in compliance with other authors.

for the SUSE manuals we are simply using <screen></screen> for terminal
output. If mentioning a command within floating text, we use
<command></command>:

<screen>~ > pwd
/home/tux</screen>

<para>
  To list the curent working directory use the command
  <command>pwd</command>.
</para>

> Also, its been awhile since I wrote with novdoc; what
> wrapping/hyphenation directives are available to authors? I've got
> output that is 100-105 columns wide. Looks ugly on the pdf....simply
> concatenates.

Yes, 100-105 columns is a bit too wide. However, I do not remember the
exact width. It also depends on the element - screens use a wide
mono-spaced font, for example. Displaying such widths will
completely fail in screens, because no automatic line breaks are
inserted. However, if you really need to use such a width, you can
manually set a different font-size via processing instruction. However,
this only works with the SUSE stylesheets, the DocBook stylesheets will
not suppport it.

<?dbsuse-fo font-size="0.6em"?>
or
<?dbsuse-fo font-size="7pt"?>

Use "em" if you create HTML/ePUB output. If you only create PDF output,
you may alternatively use "pt".

You need to place the PI directly after the block element, e.g.

<screen><?dbsuse-fo font-size="0.63em"?>
...
</screen>



--
Regards
        Frank

Frank Sundermeyer, Technical Writer, Documentation
SUSE Linux Products GmbH, Maxfeldstr. 5, D-90409 Nuernberg
Tel: +49-911-74053-0, Fax: +49-911-7417755;  http://www.opensuse.org/
SUSE Linux Products GmbH, GF:
Jeff Hawn, Jennifer Guild, Felix Imend├Ârffer, HRB 16746 (AG N├╝rnberg)
"Reality is always controlled by the people who are most insane" Dogbert

signature.asc (205 bytes) Download Attachment