X-Recipient: archive-cygwin AT delorie DOT com
DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id
	:list-unsubscribe:list-subscribe:list-archive:list-post
	:list-help:sender:message-id:date:from:mime-version:to:subject
	:references:in-reply-to:content-type:content-transfer-encoding;
	 q=dns; s=default; b=Rfflj4o27e+F61ILorpua+rnUFMZizbBekBMKm7IgeX
	5J6aif1Bf4hqLgRjPwN+siMELBdQgT8sg/wJKhIicPMv0YCpgTWQw4e+a/Tcci8G
	PhaV27yzYzuj6uqTn/U7LBWCxsW/NLtBd/ZL6V4vrJJ6zmTHqqLVLYPUL+JOfLNc
	=
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=sourceware.org; h=list-id
	:list-unsubscribe:list-subscribe:list-archive:list-post
	:list-help:sender:message-id:date:from:mime-version:to:subject
	:references:in-reply-to:content-type:content-transfer-encoding;
	 s=default; bh=tweVfUR5jbNAMM6c/n/B2nenZNs=; b=TuEJq94i+b5aF67JC
	142h5PNJ/G1E9T1SbcDpMxgUju0VPUZR9dLKVurKzBQN51fsbuGYuKKyNiIL28sG
	LIxbCbxUXgjeiRWaLxWtRpydFidOxc3ETB5s+68kh/4xkFdLZnmHrnccUZag6OV+
	thQmnTstSJ6yuNOMe9tpMrrfIc=
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id: <cygwin.cygwin.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
X-Spam-SWARE-Status: No, score=-2.6 required=5.0 tests=AWL,BAYES_00,KHOP_THREADED,RP_MATCHES_RCVD autolearn=ham version=3.3.1
Message-ID: <518D8085.8020203@tlinx.org>
Date: Fri, 10 May 2013 16:19:33 -0700
From: Linda Walsh <cygwin AT tlinx DOT org>
User-Agent: Thunderbird
MIME-Version: 1.0
To: cygwin AT cygwin DOT com
Subject: Re: Cygwin manpages clobbered
References: <5F8AAC04F9616747BC4CC0E803D5907D0AF787B3 AT MLBXv04 DOT nih DOT gov> <518C55BD DOT 7020807 AT etr-usa DOT com> <20130510041245 DOT GA3019 AT ednor DOT casa DOT cgf DOT cx> <518CC275 DOT 2060207 AT etr-usa DOT com>
In-Reply-To: <518CC275.2060207@etr-usa.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit

Warren Young wrote:
> On 5/9/2013 22:12, Christopher Faylor wrote:
> I haven't tried digging further to figure out how these man pages were
>     http://etr-usa.com/cygwin/doc/test/ccp.3
>     http://etr-usa.com/cygwin/doc/test/ccp.pdf

> I think these outputs look pretty good, myself.  The HTML is the least
> impressive, and it can be fixed with some CSS.  (Code snippets should be
> indented, for example.)
----
	The manpage looks way cleaned up using color for "double-quoted"
hi-lighting... By intent or by accident -- it looks good!

(for those who didn't bother to generate it,
on 80 char screen formatting looks like):

CYGWIN_CONV_PATH(3)               Cygwin API               CYGWIN_CONV_PATH(3)



NAME
       cygwin_conv_path - convert POSIX paths to Windows paths, and vice versa

SYNOPSIS
       #include <sys/cygwin.h>


       ssize_t cygwin_conv_path(cygwin_conv_path_t what, const void* from,
                                void* to, size_t size);

DESCRIPTION
       Use this function to convert POSIX paths in from to Win32 paths in to
       or, vice versa, Win32 paths in from to POSIX paths in to.  what defines
       the direction of this conversion and can be any of the below values.

           CCP_POSIX_TO_WIN_A   /* from char* POSIX to char* Win32    */
           CCP_POSIX_TO_WIN_W,  /* from char* POSIX to wchar_t* Win32 */
           CCP_WIN_A_TO_POSIX,  /* from char* Win32 to char* POSIX    */
           CCP_WIN_W_TO_POSIX,  /* from wchar_t* Win32 to char* POSIX */


       You can additionally or the following values to what, to define whether
       you want the resulting path in to to be absolute or if you want to keep
       relative paths in relative notation. Creating absolute paths is the
       default.

           CCP_ABSOLUTE = 0,       /* Request absolute path (default). */
           CCP_RELATIVE = 0x100    /* Request to keep path relative.   */


                          ....
----
BTW, though, its not just specific to your scripts, but the PDF code font
is less than optimal.. it's a thin, bit-mapped font w/no anti-aliasing
against a grey background.  It's readable, but barely.  If it was printed,
it would really depend on the printer whether or not it would be legible.
Some of the caps in the code like "LA" with the serif's run-together.

Maybe a non-serif font for the code would work better?  Or something with
thicker lines?


Otherwise, looking good....




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