<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Mar 24, 2014 at 3:26 AM, Gauvain Pocentek <span dir="ltr"><<a href="mailto:gauvain.pocentek@objectif-libre.com" target="_blank">gauvain.pocentek@objectif-libre.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">Le 2014-03-21 14:15, Anne Gentle a écrit :<div class=""><br>


<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
On Fri, Mar 21, 2014 at 3:52 AM, Andreas Jaeger <<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>> wrote:<br>
<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
On 03/20/2014 09:37 PM, Diane Fleming wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
But I'm willing to go along with the consensus on this. And I totally<br>
agree that we need to have one convention that we all use.<br>
<br>
But here's why I like two screens:<br>
<br>
1. You can insert text between the user input and the computer output,<br>
such an explanation of what the user might see in the output.<br>
</blockquote>
<br>
You still can do this, I see no problem with that.<br>
</blockquote>
<br>
In the Ops Guide, we standardized on one screen wrapping <userinput><br>
and <computeroutput> but even so it was causing oddities with their<br>
transforms. <br>
<br>
I'd prefer <screen> around each. <br>
</blockquote>
<br></div>
OK. So to sum up, we're (I'm?) not happy with our tools rendering when using multiple <screen>s, and we have rendering issues when using a single <screen> too, although this only concerns the ops guide. Did I understand correctly?<br>


<br>
Rendering set aside, I think that one screen is more logical, because you don't type the command in one terminal, and get the output in another one. And prompts explicitly define what is to be typed.<br>
<br>
To reuse an argument from the basic OS setup discussion that took place yesterday ([0]), we can probably assume that users know how to use the command line, and that they will understand what is to be typed and what is the output.<br>

</blockquote><div><br></div><div>No, please don't use that argument again.</div><div><br></div><div>I was hoping a DocBook markup expert would give us guidance. I think that semantically speaking, <screen> is meant to indicate all that someone sees on a screen. To quote from the DocBook reference,</div>

<div><br></div><div><a href="http://docbook.org/tdg5/en/html/screen.html">http://docbook.org/tdg5/en/html/screen.html</a><br></div><div><p style="color:rgb(0,0,0);font-family:Times;font-size:medium">A <a href="http://docbook.org/tdg5/en/html/screen.html"><code class="">screen</code></a> is a verbatim environment for displaying text that the user might see on a computer terminal. It is often used to display the results of a command.</p>

<p style="color:rgb(0,0,0);font-family:Times;font-size:medium">Having less specific semantic overtones, <a href="http://docbook.org/tdg5/en/html/screen.html"><code class="">screen</code></a> is often used wherever a verbatim presentation is desired, but the semantic of <a href="http://docbook.org/tdg5/en/html/programlisting.html"><code class="">programlisting</code></a> is inappropriate.</p>

</div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<br>
Let's try to move forward and make a decision about this, this shouldn't be that hard :)<br></blockquote><div><br></div><div>It's hard because the semantics aren't specific. I am fine with a single <screen> since that is what the user sees. I think we can make the output nicer. Feel free to file a bug with the doc-builds tag for openstack-manuals.</div>

<div><br></div><div>Thanks,</div><div>Anne</div><div><br></div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">


<br>
Thanks,<br>
Gauvain<br>
<br>
[0]: <a href="http://lists.openstack.org/pipermail/openstack-docs/2014-March/004144.html" target="_blank">http://lists.openstack.org/<u></u>pipermail/openstack-docs/2014-<u></u>March/004144.html</a><br>
</blockquote></div><br></div></div>