screenshot instructions

[Paul W. Frields]

On Wed, 2004-09-01 at 10:10, Dashamir Hoxha wrote:
> On Wednesday 01 September 2004 03:45 pm, Paul W. Frields wrote:
> > <screen>
> >   <computeroutput>
> > # The following line should be changed.
> > MyVariable = <userinput>NewValue</userinput>
> > MyVariableContext = default
> >   </computeroutput>
> > </screen>
> 
> What I suggested is this:
> <screen>
> # The following line should be changed.
> MyVariable = <userinput>NewValue</userinput>
> MyVariableContext = default
> </screen>
> 
> I don't see anything wrong with your version.
> Do you see anything wrong with my version?
> If not, why the usage of <computeroutput>
> should be enforced by a rule?

Nothing wrong with it, I just think using <*put> throughout is more
descriptive. "On the screen, the computer outputs XXX."

> Actually, for configuration files (and for anything
> that can be edited) I would prefer something like this:
> <programlisting>
> # The following line should be changed.
> MyVariable = <emphasis>NewValue</emphasis>
> MyVariableContext = default
> </programlisting>

I could agree with the <programlisting> part here, but I think in the
interest of consistency and sensibility, use <userinput> instead of
<emphasis> if that's something the user is expected to enter. Again, I
think these are minor points and are probably just better left for an
editor to simply fix as required or desired, provided the sense and
context are unaffected by a change.

-- 
Paul W. Frields, RHCE