<br><div class="gmail_extra"><br><br><div class="gmail_quote">On Sun, Dec 2, 2012 at 12:40 AM, Justin B Rye <span dir="ltr"><<a href="mailto:jbr@edlug.org.uk" target="_blank">jbr@edlug.org.uk</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
Christian PERRIER wrote:<br>
> Template: sheepdog/start<br>
> Type: boolean<br>
> Default: true<br>
> _Description: Automatically start the sheepdog service?<br>
>  Please choose whether you want the shhepdog service to<br>
>  start automatically when the system is booted.<br>
<br>
Typo: s/shhep/sheep/.  And no need to phrase it as a decision about<br>
what I want -<br>
<br>
    Please choose whether the sheepdog service should start automatically<br>
    when the system is booted.<br>
<br>
> Template: sheepdog/daemon_args<br>
> Type: string<br>
> Default:<br>
> _Description: Arguments for the sheepdog daemon:<br>
>  If no argument is given, the sheepdog daemon is started with the corosync driver on<br>
>  port 7000.<br>
<br>
Shouldn't this start with something like:<br>
<br>
   Please choose the commandline arguments that should be passed to the<br>
   sheepdog daemon. If no argument is given, the default behavior is to<br>
   start with the corosync driver on port 7000.<br></blockquote><div>In the sheep(8), this is descripte as <br><br>This option specifies the IP port over which sheep looks for other sheepdog cluster nodes.<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">

<br>
(Does that mean "with 7000 as the corosync driver port" or is it two<br>
things, "start on port 7000, using the corosync driver"?  Or will<br>
sheepdog users find it obvious?)<br>
<br>
>  .<br>
>  Addition arguments are:<br>
<br>
As MES spotted, s/Addition/Additional/, but "additional" to what?<br>
<br>
   Available options include:<br>
<br>
>    -p, --port              specify the TCP port to listen to<br>
>    -l, --loglevel          specify the level of logging detail<br>
>    -d, --debug             include debug messages in the log<br>
>    -D, --directio          use direct I/O when accessing the object store<br>
>    -z, --zone              specify the zone ID<br>
>    -c, --cluster           specify the cluster driver<br>
>  More infomation can be found in the sheep(8) manual page.<br>
            ^<br>
s/fom/form/.  I suppose it doesn't matter that we could do all this<br>
with a one-column indent and less of a gap.  I was surprised to learn<br>
that the controlling daemon is called "sheep", though...<br>
<br>
The package description is really quite good:<br>
<br>
> -Description: Distributed storage system for KVM/QEMU<br>
> +Description: distributed storage system for KVM/QEMU<br>
>   Sheepdog provides highly available block level storage volumes that can be<br>
>   attached to KVM/QEMU virtual machines. Sheepdog scales to several hundreds<br>
                                                                             ^<br>
>   nodes, and supports advanced volume management features such as snapshot,<br>
>   cloning, and thin provisioning.<br>
<br>
"Highly available" isn't something I'd naturally say, but people who<br>
care about this topic seem to, so fair enough.  It's possible this<br>
use of "snapshot" to mean "snapshotting"/"snapshot capability" is a<br>
similar piece of jargon, but I'd prefer to avoid it by recycling that<br>
surplus S from the line before:<br>
<br>
    Sheepdog provides highly available block level storage volumes that can be<br>
    attached to KVM/QEMU virtual machines. Sheepdog scales to several hundred<br>
    nodes, and supports advanced volume management features such as snapshots,<br>
    cloning, and thin provisioning.<br>
<span class=""><font color="#888888"><br>
--<br>
JBR     with qualifications in linguistics, experience as a Debian<br>
        sysadmin, and probably no clue about this particular package<br>
</font></span><br>_______________________________________________<br>
Openstack-devel mailing list<br>
<a href="mailto:Openstack-devel@lists.alioth.debian.org">Openstack-devel@lists.alioth.debian.org</a><br>
<a href="http://lists.alioth.debian.org/mailman/listinfo/openstack-devel" target="_blank">http://lists.alioth.debian.org/mailman/listinfo/openstack-devel</a><br>
<br></blockquote></div><br><br clear="all"><br>-- <br>YunQiang Su <br>
</div>