[Perkamon-l10n-fr] Reorganisation des pages

[Denis Barbier]

Le 16 novembre 2010 23:05, Florentin Duneau a écrit :
> On 12:20 Sun 14 Nov, Denis Barbier wrote:
>> Le 13 novembre 2010 00:55, Florentin Duneau a écrit :
>> [...]
>> > Voilà comment je procède :
>> >
>> > 1. Préparation du tri:
>> >
>> > $ python perk-tool.py msort ../man-pages/man*/
>> >
>> > Cette commande permet de faire un tri large de toutes les pages. J'ai
>> > sauvegardé le résultat dans le fichier tools/tri.all livré sous git.
>> >
>> > Ensuite tout se fait à la main.
>> >
>> > A partir du fichier tri.all, je vérifie le tri manuellement et je le
>> > réorganise si besoin. Lorsqu'un groupe (un nom de cfg et une liste de pages)
>> > me semble OK, je le déplace dans le fichier tools/reorg.conf (on peut bien
>> > entendu ajouter des pages à un groupe par la suite). Au fur à mesure, le
>> > fichier tools/tri.all se vide et le fichier tools/reorg.conf se remplie, donc
>> > quand le premier sera vide, on aura terminé le tri.
>> [...]
>>
>> Ok, j'ai encore quelques questions.
>>
>>  1. Dans perk-tool.py, il y a une gestion des sections SEE ALSO, mais
>> je ne vois pas comment ça s'utilise. Par exemple, pour chaque fichier
>> de tri.all, j'aimerais bien voir les fichiers listés dans SEE ALSO,
>> ainsi que la section @ si le fichier apparaît dans reorg.conf. Est-ce
>> que c'est faisable ?
>>
>
> J'ai fait un truc rapide : pour toutes les pages de tri.all (donc les pages
> encore non triées), j'affiche les pages see_also ainsi que leur groupe entre
> parenthèses si elles sont triées. Par contre, pour l'instant, on perd
> l'organisation par groupe qui existe dans tri.all.
>
> C'est que tu voulais ?

Si je prends par exemple elf.5 dans le fichier joint, il liste
  core.5 (), ELFOSABI_TRU6.4 (), as.1 (), ld.1 (), ELFCLASS6.4 (),
objdump.1 (), EM_38.6 (), EM_SPARCV.9 (), ELFCLASS3.2 (), EM_X86_6.4
(), execve.2 (unistd), EM_M3.2 (), gdb.1 (), EM_PPC6.4 (), EI_MAG.0
(), EI_MAG.1 (), EI_MAG.2 (), EI_MAG.3 (), EM_S39.0 (), EM_86.0 (),
EM_IA_6.4 (),

Beaucoup de ces pages n'existent pas, elles ne sont d'ailleurs pas
listées dans SEE ALSO. Tu sembles donc récupérer ce qui vient après
  .BR
Serait-il possible de n'avoir dans see_also que les pages
effectivement dans la section SEE ALSO ?

Sinon, afin d'y voir plus clair, ne serait-il pas préférable de
réorganiser déjà dans master les gros morceaux que tu as identifiés ?
En partant de tools/reorg.conf, je vois au moins les candidats
suivants :
  1. math et complex peuvent être regroupés ensemble
  2. stdio+aio+fcntl
  3. charset+iconv+wchar+wctype+string
  4. pthread
  5. net+netlink
  6. memory+numa
Qu'en penses-tu ?

Denis