LVM documentation

Hi folks, 

I have written some LVM documentation some time ago, but I don't have needed tools nor knowledge to commit it
in to our guide. Now when LVM is build by default I would like to have this doc in guide, too. Documentation is
located at [1] and image referenced by this document can be located at [2]. Can anyone look at this and add it
to guide ?

[1] www.netbsd.org/~haad/lvm.xml
[2] www.netbsd.org/~haad/lvm.png

Regards

Adam.

Re: LVM documentation

On Tue, 8 Dec 2009, Adam Hamsik wrote:
> I have written some LVM documentation some time ago, but I don't have 
> needed tools nor knowledge to commit it in to our guide. Now when LVM is 
> build by default I would like to have this doc in guide, too. 
> Documentation is located at [1] and image referenced by this document 
> can be located at [2]. Can anyone look at this and add it to guide ?

Done - it'll be online within one hour.
It's in the NetBSD Guide at http://www.NetBSD.org/docs/guide/en/ and also 
in the PDF version.

Thanks!

  - Hubert

envsys.4 && sysmon_envsys.9: grammar corrections

Hi, 

A few grammar corrections for envsys.4 and sysmon_envsys.9 are attached.

Best regards,
Constantine. 

From eb80390af5b5ca64c3c6d44dde68b4b4478d5e60 Mon Sep 17 00:00:00 2001
From: Constantine A. Murenin <cnst+netbsd <at> bugmail.mojo.ru>
Date: Tue, 3 Nov 2009 01:00:07 -0500
Subject: [PATCH 1/2] grammar

---
 share/man/man4/envsys.4 |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/share/man/man4/envsys.4 b/share/man/man4/envsys.4
index 43f6435..8d872e0 100644
--- a/share/man/man4/envsys.4
+++ b/share/man/man4/envsys.4
 <at>  <at>  -157,7 +157,7  <at>  <at>  Let's explain some more about those objects:
 .It Fa allow-rfact
 Set to
 .Em true
-mean that the sensor is able to change the resistor factor,
+means that the sensor is able to change the resistor factor,
 only used in Voltage sensors.
 .It Fa avg-value
 Current average value in the sensor.

some beginner feedback

Well, I'm not sure you would call me a beginner.  I used NetBSD a little bit
about 8 years ago, but don't remember much.  I do have a fair amount of
experience with OpenBSD and FreeBSD, though.

Specifically I have had trouble with the web site docs and I think some of it
could be fixed just by organizing things a bit better.  The First Steps section
is very disorganized from my perspective of trying to get a newly installed
system working.

The first thing on my mind is configuring the network...

The first steps section starts by talking about possible boot problems or lack
of configuration after install, but I can't help but think this could instead
be a link to an entire troubleshooting section.  It just seemed a distraction
to me.  I understand that it wouldn't to someone who had these problems, but I
think being directed to a problem solving section would be a good step for
those folks.  Maybe even comforting to know that there is this entire section
of fixes waiting for them that has more detail.

The next section about using man is also a good thing to have, but the detail
is a bit much for first steps.  Maybe just suggest afterboot and then link to
another section with more detail.

Then there is a section that suggests learning vi, which is good advice, but I
think saying that at the top of the page instead of making it a section would
be more helpful.

	It also makes no sense to place these two sections before the section
on Login (unless the vi advice is the first thing one sees, but maybe that
should even be before installation if someone is that new).  Speaking of,

Re: some beginner feedback

In article <20091218114247.d32f5c04.timh <at> dirtymonday.net>,
Tim Howe  <timh <at> dirtymonday.net> wrote:

>	Anyway...  My real reason for going into all this is that I am willing
>to help write and organize this documentation if allowed.  Who should I talk
>to?  Where do I start?

Hi and thanks for offering to help. The best place to start is to work on
fixing the things you don't like and supply replacements and or patches,
preferably as PR reports.

Have fun,

christos

Re: envsys.4 && sysmon_envsys.9: grammar corrections

On Dec 16, 2009, at 1:12 PM, Constantine Aleksandrovich Murenin wrote:

> A few grammar corrections for envsys.4 and sysmon_envsys.9 are attached.

I've committed them, aside from the "there's" change, which is not an error but simply an issue of style. 
Contractions run wild throughout our tree, so I don't see any reason to change that particular one.

Thanks for the fixes!

Soren

Re: some beginner feedback

On Dec 18, 2009, at 2:23 PM, Christos Zoulas wrote:

> In article <20091218114247.d32f5c04.timh <at> dirtymonday.net>,
> Tim Howe  <timh <at> dirtymonday.net> wrote:
> 
>> 	Anyway...  My real reason for going into all this is that I am willing
>> to help write and organize this documentation if allowed.  Who should I talk
>> to?  Where do I start?
> 
> Hi and thanks for offering to help. The best place to start is to work on
> fixing the things you don't like and supply replacements and or patches,
> preferably as PR reports.

Also feel free to send me mail about any changes you'd like to have made.  I've had my hands in the Guide lately,
and I'd be glad to work with you to fix it up.

Soren

Re: envsys.4 && sysmon_envsys.9: grammar corrections

2009/12/18 Soren Jacobsen <snj <at> pobox.com>:
> On Dec 16, 2009, at 1:12 PM, Constantine Aleksandrovich Murenin wrote:
>
>> A few grammar corrections for envsys.4 and sysmon_envsys.9 are attached.
>
> I've committed them, aside from the "there's" change, which is not an error but simply an issue of style.
 Contractions run wild throughout our tree, so I don't see any reason to change that particular one.
>
> Thanks for the fixes!
>
> Soren

Perhaps all "there's" should be changed to "there is" then?  I think
"it's" is generally acceptable, even if less so than "it is", whereas
"there's" is almost always considered to be a very informal style.

There's not much work in changing it anyways:

dale# find share/man -type f | xargs fgrep "there's" && uname -ms
share/man/man4/ipsec.4:so for the receiving kernel there's no sign of
authenticity
share/man/man4/man4.vax/dn.4:The device doesn't exist, or there's no
power to it.
share/man/man9/kauth.9:there's no way to tell what structure
share/man/man9/kfilter_register.9:if there's an invalid argument, or
share/man/man9/kfilter_register.9:if there's an invalid argument, or
share/man/man9/sysmon_envsys.9:If there's some error before
registering the device, the
share/man/man9/sysmon_envsys.9:object will be freed, so there's no need to call
NetBSD i386

Re: envsys.4 && sysmon_envsys.9: grammar corrections

On Dec 18, 2009, at 6:42 PM, Constantine Aleksandrovich Murenin wrote:

> 2009/12/18 Soren Jacobsen <snj <at> pobox.com>:
>> 
>> I've committed them, aside from the "there's" change, which is not an error but simply an issue of style. 
Contractions run wild throughout our tree, so I don't see any reason to change that particular one.
> 
> Perhaps all "there's" should be changed to "there is" then?

I don't think so.  I certainly wouldn't commit such changes.  Like I said, contractions (not just "there's")
are all over the place in our documentation.  Quite a lot of them are informal.  I don't think this is a real
problem.  In some cases, I think it's even a good thing.  There's only one contraction I'd ever want to (but
wouldn't actually) ban from the tree, and that is "it's," but that's just because people so often use it improperly.

> There's

  ^^^^^^^ ;)

> dale# find share/man -type f | xargs fgrep "there's" && uname -ms

It doesn't make much difference to me whether it's "only 7" or not, but for the record, there are more than 7:

./crypto/dist/heimdal/appl/login/login.access.5:If there's a user and a group with the same name,
there is no way to
./crypto/dist/heimdal/lib/krb5/krb5_config.3:For the default functions, other than for the string
case, there's no
./crypto/external/bsd/openssl/lib/libcrypto/man/BN_num_bytes.3:there's no real guarantee that
will match the \*(L"key size\*(R", just a lot
./crypto/external/bsd/openssl/lib/libcrypto/man/openssl_ui.3:there's no technical difference
between them.  Other methods may make a

Re: envsys.4 && sysmon_envsys.9: grammar corrections

2009/12/19 Soren Jacobsen <snj <at> pobox.com>:
> On Dec 18, 2009, at 6:42 PM, Constantine Aleksandrovich Murenin wrote:
>> There's
>
>  ^^^^^^^ ;)

Fair enough! 

C.