Re: No 6.05/.01 pdf book available

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1.1: Type: text/plain, Size: 2661 bytes --]

Hi Deri,

On 2023-08-21 01:39, Deri wrote:
> Hi Brian,
> 
> I have created the tar files again with the latest sort.
> 
> Both are intended to be used with groff 1.23.0, but the plus version includes 
> the latest gropdf, so produces more compact output. It also has the narrower 
> gap between the heading on the intro(1) page, I have not investigated the 
> reason yet!
> 
> Also I have a small bone to pick with your "official" sort order - it's not 
> consistent. Most people expect a short word like "cat" to appear before a word 
> like "catatonic", and we see "hosts" does appear before "hosts.equiv", so why 
> does "man" come after "man-pages"! I've also strayed from the official sort 
> order in the 6.05.01 pdf by arranging the latin and iso character code pages 
> in proper numerical order so "latin10" comes after "latin9" rather than 
> following "latin1". I hope this makes sense.

Is "official" the Book for 6.5.1?  Or is it the scripts/sortman in git HEAD?

I've found that scripts/sortman had this problem that you report, and fixed it:

commit a04e93998bebba77ac799dd89c11042c25f2e2d2 (HEAD -> master, korg/master, alx/main, main)
Author: Alejandro Colomar <alx@kernel.org>
Date:   Mon Aug 21 23:55:18 2023 +0200

    scripts/sortman: Sort 'cat' before 'catatonic'
    
    Reported-by: Deri James <deri@chuzzlewit.myzen.co.uk>
    Cc: Brian Inglis <Brian.Inglis@Shaw.ca>
    Signed-off-by: Alejandro Colomar <alx@kernel.org>

diff --git a/scripts/sortman b/scripts/sortman
index 546a7943d..a8f70bab5 100755
--- a/scripts/sortman
+++ b/scripts/sortman
@@ -7,8 +7,9 @@ sed   -E '/\/intro./  s/.*\.([[:digit:]])/\10\t&/' \
 | sed -E '/\/intro./! s/.*\.([[:digit:]])\>/\11\t&/' \
 | sed -E '/\/intro./! s/.*\.([[:digit:]])([[:alpha:]][[:alnum:]]*\>)/\12.\2\t&/' \
 | sed -E '            s/\t(.*)/&\n\1/' \
+| sed -E '/\t/        s/\.[[:digit:]]([[:alpha:]][[:alnum:]]*)?\>.*//' \
 | sed -E '/\t/        s/\/[_-]*/\//g' \
 | sed -E '/\t/        s/[_-]/_/g' \
 | sed -E '/\t/        {N;s/\n/\t/;}' \
-| sort -fV \
+| sort -fV -k1,2 \
 | cut -f3;


$ ./scripts/sortman << __EOF__
man7/cat.7
man7/catatonic.7
man7/cat_or_dog.7
man7/cat_alike.7
man7/hosts.7
man7/hosts.equiv.7
man7/intro.7
__EOF__
man7/intro.7
man7/cat.7
man7/catatonic.7
man7/cat_alike.7
man7/cat_or_dog.7
man7/hosts.7
man7/hosts.equiv.7

Is this order a good one?  Should maybe cat_alike go right after cat?

Cheers,
Alex

[Hopefully, this email should already be signed; I've recovered my keys.]

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]