X-Recipient: archive-cygwin AT delorie DOT com
X-SWARE-Spam-Status: No, hits=-0.9 required=5.0 	tests=AWL,BAYES_00,SARE_MSGID_LONG40,SPF_PASS,SUBJECT_FUZZY_TION
X-Spam-Check-By: sourceware.org
MIME-Version: 1.0
In-Reply-To: <20090308100949.GP31459@calimero.vinschen.de>
References: <6509bebe0903080036h78d62a51j3b32b464736cff1a AT mail DOT gmail DOT com> 	 <20090308100949 DOT GP31459 AT calimero DOT vinschen DOT de>
Date: Sun, 8 Mar 2009 02:47:10 -0800
Message-ID: <6509bebe0903080347t551317e4g5c9218070651b7a2@mail.gmail.com>
Subject: Re: doc suggestions for User Guide's "Special filenames", including  	`cat /proc/partitions`
From: S Page <skierpage AT gmail DOT com>
To: cygwin AT cygwin DOT com
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
X-IsSubscribed: yes
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
Precedence: bulk
List-Id: <cygwin.cygwin.com>
List-Unsubscribe: <mailto:cygwin-unsubscribe-archive-cygwin=delorie DOT com AT cygwin DOT com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com

Corinna Vinschen wrote:
> Can you please check against the latest documentation under
> http://www.cygwin.com/1.7/cygwin-ug-net/using-specialnames.html
> and see if it explains anything better in this regard?

The "POSIX devices" section is much the same.

> If not, I'm open to suggestions to make the documentation clearer,

I provided 7 specific suggestions in my message, I hope someone can
eventually act on them.  I don't know SGML well, and the 130 minutes I
spent figuring out and composing them is more time than I intended to
spend on this.  Sorry.
(An 8th suggestion; consider allowing comments on online doc pages,
like http://php.net/manual/ or Adobe LiveDocs .)

I early wrote
> I also ran into a glitch where any and every variation of
> `df /dev/sdXN` gives information for my first partition,
D'oh of course. `df /path/to/some/file` gives info on the partition
holding that file, and all /dev files are in the same directory on the
same partition.  I couldn't figure out a way in cygwin to get more
info about a disk or partition from its /dev/ entry.  A command like
`od -c /dev/sdb6 | head -3` will give an error if a partition or disk
does not exist.

Regards,
--
=S Page

--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Problem reports:       http://cygwin.com/problems.html
Documentation:         http://cygwin.com/docs.html
FAQ:                   http://cygwin.com/faq/