[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[SCM] gawk branch, feature/docit, updated. gawk-4.1.0-5389-ga1a02e29
|
From: |
Antonio Giovanni Colombo |
|
Subject: |
[SCM] gawk branch, feature/docit, updated. gawk-4.1.0-5389-ga1a02e29 |
|
Date: |
Fri, 20 Oct 2023 09:37:45 -0400 (EDT) |
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".
The branch, feature/docit has been updated
via a1a02e299412a7eb4b901bb0947168fd68e46689 (commit)
from b488e3dc713c2dc62f7df5f026a070361b2a0161 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=a1a02e299412a7eb4b901bb0947168fd68e46689
commit a1a02e299412a7eb4b901bb0947168fd68e46689
Author: Antonio Giovanni Colombo <azc100@gmail.com>
Date: Fri Oct 20 15:36:08 2023 +0200
source for the Gawk book from gawktexi.in to gawk.texi
diff --git a/doc/it/ChangeLog b/doc/it/ChangeLog
index bed1cd8a..796482b0 100755
--- a/doc/it/ChangeLog
+++ b/doc/it/ChangeLog
@@ -1,3 +1,15 @@
+2023-10-20 Antonio Giovanni Colombo <azc100@gmail.com>
+
+ * gendocs.sh: Updated.
+ * gawk.texi: Added.
+ * README.txt: Updated.
+ * genera_formati.sh: Updated.
+ * compila_gawk.sh: Added.
+ * gawktexi.in: Dropped.
+ * sidebar.awk: Dropped.
+ * compila_originale.sh: Dropped.
+ * compila_smallprint.sh: Dropped.
+
2023-10-13 Antonio Giovanni Colombo <azc100@gmail.com>
* gawktexi.in: Updated.
diff --git a/doc/it/README.txt b/doc/it/README.txt
old mode 100644
new mode 100755
index ad630981..2d4ee940
--- a/doc/it/README.txt
+++ b/doc/it/README.txt
@@ -8,27 +8,22 @@ computer in cui si scarica la distribuzione di gawk.
utente della funzionalità di Memoria Persistente (pm-gawk),
disponibile a partire dalle versione 5.2 di Gawk.
-Se la sola cosa che interessa è avere una copia del libro
-GAWK e/o del manuale pm-gawk in formato PDF,
+Se la sola cosa che interessa è avere una copia del
+libro Gawk e/o del manuale pm-gawk in formato PDF,
queste possono semplicemente essere scaricate dal sito:
https://sites.google.com/view/gawkdoc-it/home-page
-Per generare il libro localmente, sono disponibili due shell
-script:
+Per generare il libro localmente, è disponibile uno
+shell script:
-compila_originale.sh
+compila_gawk.sh
-compila_smallprint.sh
-
-La sola differenza è la dimensione della pagina stampata,
-che è più piccola usando il secondo script.
-
-Un terzo script:
+Un secondo script:
genera_formati.sh
-genera il libro in vari formati, fra cui i formati
+genera il libro Gawk in vari formati, fra cui i formati
testo, html e info.
Per generare il Manuale Utente per la Memoria Persistente
@@ -37,6 +32,6 @@ in gawk, è disponibile lo script:
compila_pma.sh
Per eventuali problemi con la traduzione italiana del
-libro Gawk e/o del Manuale pm-gawk, fare riferimento
+libro Gawk e/o del Manuale utente pm-gawk, fare riferimento
agli indirizzi email dei traduttori, inseriti all'inizio
della versione PDF del libro Gawk.
diff --git a/doc/it/compila_originale.sh b/doc/it/compila_gawk.sh
similarity index 80%
rename from doc/it/compila_originale.sh
rename to doc/it/compila_gawk.sh
index 06d53b93..8ee037af 100755
--- a/doc/it/compila_originale.sh
+++ b/doc/it/compila_gawk.sh
@@ -7,10 +7,6 @@ echo "Building the pdf version of the gawk manual"
echo "in directory:"
pwd
echo "Beware, it can take a long time!"
-if [ -f "gawktexi.in" ]
-then
- gawk -f sidebar.awk gawktexi.in >gawk.texi
-fi
# just in case, drop previous Index
rm -f gawk.cps gawk.cp gawk.aux gawk.fn gawk.ky gawk.log gawk.pg
texi2pdf gawk.texi
diff --git a/doc/it/compila_smallprint.sh b/doc/it/compila_smallprint.sh
deleted file mode 100755
index dd8d57f4..00000000
--- a/doc/it/compila_smallprint.sh
+++ /dev/null
@@ -1,19 +0,0 @@
-#!/bin/bash
-
-# eventuali file di lavoro da elaborazioni precedenti
-rm -f gawk-it-17x24.pdf gawk-it.toc gawk-it.aux gawk-it.cp gawk-it.texi
2>/dev/null
-
-sed '{
- s/@example/@smallexample/g
- s/@end example/@end smallexample/g
- }' gawktexi.in > gawktexi-tmp.in
-
-awk -f sidebar.awk < gawktexi-tmp.in > gawk-it.texi
-
-texi2dvi -t "@set SMALLPRINT" -t "@set FOR_PRINT" -t @manuale -t "@include
margini.texi" gawk-it.texi -o gawk-it-17x24.dvi
-
-dvipdfmx --dvipdfm -p 170mm,240mm gawk-it-17x24.dvi
-
-awk -f sidebar.awk < gawktexi.in > gawk-it.texi
-
-rm gawktexi-tmp.in
diff --git a/doc/it/gawktexi.in b/doc/it/gawk.texi
similarity index 99%
rename from doc/it/gawktexi.in
rename to doc/it/gawk.texi
index 12fdadd2..02088589 100644
--- a/doc/it/gawktexi.in
+++ b/doc/it/gawk.texi
@@ -56,7 +56,7 @@
@c applies to and all the info about who's publishing this edition
@c These apply across the board.
-@set UPDATE-MONTH Aprile 2023
+@set UPDATE-MONTH Ottobre 2023
@set VERSION 5.3
@set PATCHLEVEL 0
@@ -1164,7 +1164,7 @@ Copyright dell'edizione italiana @copyright{} 2016 --
Free Software Foundation,
* Versione dell'estensione:: Informazioni sulla versione API.
* Versione estensione GMP/MPFR:: Informazioni sulla versione disponibile
di GMP ed MPFR.
-* Variabili informative di estens. API:: Variabili che forniscono informazioni
+* Variabili informative di estensione API :: Variabili che forniscono
informazioni
sull'invocazione di @command{gawk}.
* Codice predefinito di un'estensione API:: Codice predefinito di interfaccia
API.
* Modifiche dalla versione API 1:: Modifiche dalla versione 1 dell'API.
@@ -1680,10 +1680,11 @@ per quei sistemi @`e stato rimosso.}
@cindex ricetta per un linguaggio di programmazione
@cindex linguaggi di programmazione @subentry ricetta per
@cindex programmazione @subentry ricetta per linguaggi di
-@sidebar Ricetta per un linguaggio di programmazione
+@cindex riquadro @subentry Ricetta per un linguaggio di programmazione
+@cartouche Ricetta per un linguaggio di programmazione
-@multitable {2 parti di} {1 parte di @code{egrep}} {1 parte di @code{snobol}}
-@item @tab 1 parte di @code{egrep} @tab 1 parte di @code{snobol}
+@multitable {2 parti di} {1 parte di @code{egrep}} {1 parte di @code{snobol}}
+@item @tab 1 parte di @code{egrep} @tab 1 parte di @code{snobol}
@item @tab 2 parti di @code{ed} @tab 3 parti di C
@end multitable
@@ -1696,7 +1697,7 @@ parti di C. Documentare molto bene e distribuire.
Dopo ulteriori 35 anni, aggiungere il supporto per Unicode e CSV,
spruzzare leggermente con alcune funzionalit@`a di @command{gawk},
documentare ancora molto bene e distribuire.
-@end sidebar
+@end cartouche
@cindex Aho, Alfred
@cindex Weinberger, Peter
@@ -2975,7 +2976,9 @@ $ @kbd{./consiglio}
programma che gli utenti possono richiamare senza dover essere informati che
il programma @`e scritto in @command{awk}.
-@sidebar Comprendere @samp{#!}
+@cindex riquadro @subentry Comprendere @samp{#!}
+@cartouche Comprendere @samp{#!}
+
@cindex portabilit@`a @subentry @code{#!} (@dfn{script} eseguibili)
@command{awk} @`e un linguaggio @dfn{interpretato}. Ci@`o significa che il
@@ -3020,7 +3023,7 @@ di @command{awk} (ad. es. @file{/bin/awk}), e altri
ancora mettono il nome
dello @dfn{script} dell'utente (@samp{consiglio}). @value{DARKCORNER}
Non bisogna fidarsi del valore di @code{ARGV[0]}
per ottenere il nome del proprio @dfn{script}.
-@end sidebar
+@end cartouche
@node Commenti
@subsection Documentare programmi @command{gawk}.
@@ -5138,7 +5141,8 @@ Una volta disponibile la funzionalit@`a per assegnare una
variabile, l'opzione
@option{-F} per impostare il valore di @code{FS} non @`e pi@`u strettamente
necessaria. Rimane per compatibilit@`a all'indietro.
-@sidebar Proteggere le variabili della shell nella riga di comando
@command{awk}
+@cindex riquadro @subentry Proteggere le variabili della shell nella riga di
comando @command{awk}
+@cartouche Proteggere le variabili della shell nella riga di comando
@command{awk}
@cindex protezione @subentry nella riga di comando di @command{gawk}
@cindex shell @subentry protezione @subentry regole per la
@cindex stringa nulla @subentry come argomento a @command{gawk} @subentry
protezione per
@@ -5170,7 +5174,7 @@ $ @kbd{awk 'BEGIN @{ print ARGC @}' $f}
$ @kbd{awk 'BEGIN @{ print ARGC @}' "$f"}
@print{} 2
@end example
-@end sidebar
+@end cartouche
@node Specificare lo standard input
@section Come specificare lo standard input insieme ad altri file
@@ -6387,8 +6391,9 @@ anche se normalmente sarebbe un operatore di
@dfn{regexp}. Per esempio,
@cindex portabilit@`a
Per una completa portabilit@`a, non usare una barra inversa prima di qualsiasi
carattere non incluso nella lista precedente, o che non sia un operatore.
+
@c 11/2014: Moved so as to not stack sidebars
-@sidebar Barra inversa prima di un carattere normale
+@cartouche Barra inversa prima di un carattere normale
@cindex portabilit@`a @subentry barra inversa in sequenze di protezione
@cindex POSIX @command{awk} @subentry barre inverse in costanti stringa
@cindex barra inversa (@code{\}) @subentry in sequenze di protezione @subentry
POSIX e
@@ -6425,7 +6430,8 @@ Alcune altre implementazioni di @command{awk} fanno
questo.
In quelle implementazioni, immettere @code{"a\qc"} equivale a immettere
@code{"a\\qc"}.
@end table
-@end sidebar
+@end cartouche
+
Ricapitolando:
@itemize @value{BULLET}
@@ -6451,7 +6457,8 @@ Una barra inversa prima di ogni altro carattere richiede
di trattare quel
carattere letteralmente.
@end itemize
-@sidebar Sequenze di protezione per metacaratteri
+@cindex riquadro @subentry Sequenze di protezione per metacaratteri
+@cartouche Sequenze di protezione per metacaratteri
@cindex metacaratteri @subentry sequenze di protezione per
Supponiamo che si usi una protezione ottale o esadecimale
@@ -6469,7 +6476,7 @@ In modalit@`a compatibile (@pxref{Opzioni}),
@command{gawk} tratta i caratteri scritti come sequenze ottali ed esadecimali
letteramente, quando sono usati in costanti @dfn{regexp}. Quindi,
@code{/a\52b/} equivale a @code{/a\*b/}.
-@end sidebar
+@end cartouche
@node Operatori di espressioni regolari
@section Operatori di espressioni regolari
@@ -6722,7 +6729,8 @@ Per esempio, @code{/+/} individua un semplice segno
pi@`u. Tuttavia, molte altre versioni di @command{awk} trattano una
tale notazione come un errore di sintassi.
-@sidebar E se la @dfn{regexp} @`e vuota?
+@cindex riquadro @subentry E se la @dfn{regexp} @`e vuota?
+@cartouche E se la @dfn{regexp} @`e vuota?
@cindex vuote @subentry @dfn{regexps}
@cindex @dfn{regexp} @subentry vuote
Viene qui descritto un uso avanzato delle @dfn{regexp}.
@@ -6761,7 +6769,7 @@ $ @kbd{awk '}
> @kbd{@}'}
@print{} xAxBxCx
@end example
-@end sidebar
+@end cartouche
@node Espressioni di intervallo
@subsection Alcune note sulle espressioni di intervallo
@@ -7160,7 +7168,8 @@ Usare costanti @dfn{regexp} @`e la forma migliore; lascia
comprendere
chiaramente che si vuole una corrispondenza con una @dfn{regexp}.
@end itemize
-@sidebar Usare @code{\n} in espressioni tra parentesi quadre in @dfn{regexp}
dinamiche
+@cindex riquadro @subentry Usare @code{\n} in espressioni tra parentesi quadre
in @dfn{regexp} dinamiche
+@cartouche Usare @code{\n} in espressioni tra parentesi quadre in @dfn{regexp}
dinamiche
@cindex espressioni regolari @subentry dinamiche @subentry contenenti dei
ritorni a capo
@cindex ritorno a capo @subentry in @dfn{regexp} dinamiche
@@ -7190,7 +7199,7 @@ $ @kbd{awk '$0 ~ /[ \t\n]/'}
@command{gawk} non ha questo problema, e non dovrebbe accadere spesso
in pratica, ma val la pena di notarlo a futura memoria.
-@end sidebar
+@end cartouche
@node Operatori di @dfn{regexp} GNU
@section Operatori @dfn{regexp} propri di @command{gawk}
@@ -7869,7 +7878,8 @@ particolare se il testo di input che potrebbe avere una
corrispondenza con la
parte finale @`e piuttosto lungo. @command{gawk} cerca di evitare questo
problema, ma al momento non ci sono garanzie che questo funzioni sempre.
-@sidebar Avvertenze per quando si usano espressioni regolari come @code{RS}
+@cindex riquadro @subentry Avvertenze per quando si usano espressioni regolari
come @code{RS}
+@cartouche Avvertenze per quando si usano espressioni regolari come @code{RS}
Si ricordi che in @command{awk}, i metacaratteri di ancoraggio @samp{^} e
@samp{$} trovano l'inizio e la fine di una @emph{stringa}, e non l'inizio e la
fine di una @emph{riga}. Come risultato, qualcosa come
@@ -7885,7 +7895,7 @@ che un'espressione regolare sia soddisfatta da una
stringa nulla;
la suddivisione in campi non lo consente. Quindi, per esempio,
@samp{RS = "()"} @emph{non} divide un record in campi di un carattere
ciascuno.
-@end sidebar
+@end cartouche
@cindex @command{gawk} @subentry variabile @subentry @code{RT} in
@cindex @code{RT} (variabile)
@@ -7903,7 +7913,8 @@ In modalit@`a compatibile, solo il primo carattere del
valore di
da decenni. A partire dall'ottobre 2019, anche BWK @command{awk} lo permette.
Nessuna delle due versioni, tuttavia, fornisce @code{RT}.
-@sidebar @code{RS = "\0"} non @`e portabile
+@cindex riquadro @subentry @code{RS = "\0"} non @`e portabile
+@cartouche @code{RS = "\0"} non @`e portabile
@cindex portabilit@`a @subentry file di dati come un unico record
Ci sono casi in cui capita di dover trattare un intero @value{DF} come
un record unico. L'unico modo di far questo @`e quello di dare a @code{RS}
@@ -7948,7 +7959,7 @@ Capita che recenti versioni di @command{mawk} possano
usare i carattere
@xref{Funzione readfile} per un modo interessante di leggere
file interi. Se si usa @command{gawk}, si veda
@ref{Esempio di estensione Readfile} per un'altra opzione.
-@end sidebar
+@end cartouche
@node Campi
@section Un'introduzione ai campi
@@ -8289,7 +8300,8 @@ rianalizzato (sintatticamente) e ridiviso in campi usando
il valore
predefinita che aggiorna @code{$0}, come @code{sub()} e @code{gsub()}
(@pxref{Funzioni per stringhe}).
-@sidebar Comprendere @code{$0}
+@cindex riquadro @subentry Comprendere @code{$0}
+@cartouche Comprendere @code{$0}
@`E importante ricordare che @code{$0} @`e @emph{l'intero}
record, esattamente com'@`e stato letto dall'input, compresi tutti gli spazi
@@ -8305,7 +8317,7 @@ Questo non funziona, poich@'e non @`e stato fatto niente
per cambiare quello
stesso record. Invece, si deve forzare la ricostruzione del record,
tipicamente con un'istruzione come @samp{$1 = $1}, come descritto
in precedenza.
-@end sidebar
+@end cartouche
@node Separatori di campo
@@ -8655,8 +8667,8 @@ dicasi per la divisione in campi effettuata tramite
@code{FS}, @code{FIELDWIDTHS}, o @code{FPAT}.
@cindex Kernighan, Brian @subentry citazioni di
-@sidebar Carriage-Return--Line-Feed Line Endings In CSV Files
-@sidebar Fine riga dei file CSV con ritorno-carrello--a-capo
+@cindex riquadro @subentry Fine riga dei file CSV con ritorno-carrello--a-capo
+@cartouche Fine riga dei file CSV con ritorno-carrello--a-capo
@quotation
@code{\r\n} @i{@`e un'invenzione del diavolo.}
@author Brian Kernighan
@@ -8677,7 +8689,7 @@ Questo comportamento @`e consistente con i sistemi
Windows,
che convertono automaticamente la coppia CR-LF in un file
in un semplice LF in memoria; allo stesso modo si comporta
il diffuso comando di utilit@`a, @command{unix2dos}.
-@end sidebar
+@end cartouche
Il comportamento della funzione @code{split()} (ancora non
formalmente trattato, vedere @ref{Funzioni per stringhe})
@@ -8831,7 +8843,8 @@ awk -F'\n' '@var{programma}' @var{file @dots{}}
@noindent
In questo caso, @code{$1} coincide con @code{$0}.
-@sidebar Cambiare @code{FS} non incide sui campi
+@cindex riquadro @subentry Cambiare @code{FS} non incide sui campi
+@cartouche Cambiare @code{FS} non incide sui campi
@cindex POSIX @command{awk} @subentry separatore di campo
@cindex separatore di campo @subentry POSIX e il
@@ -8877,7 +8890,7 @@ root:x:0:0:Root:/:
(Il comando @command{sed}@footnote{Il programma di utilit@`a @command{sed} @`e
un
``editore di flusso''. Anche il suo comportamento @`e definito dallo standard
POSIX.} appena visto stampa solo la prima riga di @file{/etc/passwd}.)
-@end sidebar
+@end cartouche
@node Sommario sulla separazione campi
@subsection Sommario sulla separazione dei campi
@@ -8920,7 +8933,9 @@ Ogni sinngolo carattere nel record diventa un campo
separato.
(Questa @`e un'estensione comune; non @`e specificata dallo standard POSIX.)
@end table
-@sidebar @code{FS} e @code{IGNORECASE}
+@cindex riquadro @subentry @code{FS} e @code{IGNORECASE}
+@cartouche @code{FS} e @code{IGNORECASE}
+
La variabile @code{IGNORECASE}
(@pxref{Variabili modificabili dall'utente})
influisce sulla divisione del campo @emph{solo} quando il valore di @code{FS}
@@ -8940,7 +8955,7 @@ L'output @`e @samp{aCa}. Se si vuol veramente dividere i
campi su un carattere
alfabetico ignorandone il maiuscolo/minuscolo, si deve usare un'espressione
regolare che lo far@`a in automatico (p.es., @samp{FS = "[c]"}). In questo
caso, @code{IGNORECASE} avr@`a effetto.
-@end sidebar
+@end cartouche
@node Dimensione costante
@@ -11810,7 +11825,8 @@ un tale limite. @command{gawk} consente a un programma
di
aprire tante @dfn{pipeline} quante ne consente il sistema operativo su cui
viene eseguito.
-@sidebar Inviare @dfn{pipe} alla @command{sh}
+@cindex riquadro @subentry Inviare @dfn{pipe} alla @command{sh}
+@cartouche Inviare @dfn{pipe} alla @command{sh}
@cindex shell @subentry inviare comandi tramite @dfn{pipe} alla
Una maniera particolarmente efficace di usare la ridirezione @`e quella di
@@ -11839,7 +11855,7 @@ Poi invia la lista alla shell per l'elaborazione.
@xref{Apici alla shell} per una funzione che pu@`o essere utile nel generare
righe di comando da passare alla shell.
-@end sidebar
+@end cartouche
@node FD speciali
@section File speciali per flussi standard di dati pre-aperti
@@ -12253,7 +12269,6 @@ che ne parla pi@`u dettagliatamente e fornisce un
esempio.
@node Valore restituito da @code{close}
@subsection Usare il valore di ritorno restituito da @code{close()}
-@node Usare il valore di ritorno di @code{close()}
@cindex angolo buio @subentry funzione @subentry @code{close()}
@cindex funzione @subentry @code{close()} @subentry codice di ritorno
@cindex @code{close()} (funzione) @subentry codice di ritorno
@@ -12329,8 +12344,11 @@ quando chiude una @dfn{pipe}.
@node Noflush
@section Velocizzare output da @dfn{pipe}
-@c FIXME: Add indexing
+@cindex @code{PROCINFO} (vettore) @subentry non riscrivere i buffer delle
@dfn{pipe}
+@cindex @dfn{pipe} @subentry velocizzare output
+@cindex output @subentry a @dfn{pipe} @subentry velocizzare
+@ifnotinfo
Questa
@end ifnotinfo
@ifinfo
@@ -12383,7 +12401,9 @@ quindi occorre stare attenti a quello che si fa.
@node Continuazione dopo errori
@section Abilitare continuazione dopo errori in output
-@c FIXME: Add indexing
+@cindex @code{PROCINFO} (vettore) @subentry continuazione dopo errori di I/O
+@cindex output @subentry continuazione dopo errori di I/O
+@cindex continuazione @subentry output dopo errori di I/O
@ifnotinfo
Questa
@@ -12842,7 +12862,8 @@ Le costanti ottali ed esadecimali nel codice sorgente
sono un'estensione di
(@pxref{Opzioni}),
non sono disponibili.
-@sidebar La base di una costante non influisce sul suo valore
+@cindex riquadro @subentry La base di una costante non influisce sul suo valore
+@cartouche La base di una costante non influisce sul suo valore
Una volta che una costante numerica @`e stata
convertita internamente in un numero [decimale],
@@ -12855,7 +12876,7 @@ numeri in stringhe:
$ @kbd{gawk 'BEGIN @{ printf "0x11 vale <%s>\n", 0x11 @}'}
@print{} 0x11 vale <17>
@end example
-@end sidebar
+@end cartouche
@node Costanti come espressioni regolari
@subsubsection Costanti fornite tramite espressioni regolari
@@ -13409,7 +13430,8 @@ b = a ""
@code{b} ha valore @code{"12"}, non @code{"12.00"}.
@value{DARKCORNER}
-@sidebar @command{awk} prima di POSIX usava @code{OFMT} per la conversione di
stringhe
+@cindex riquadro @subentry @command{awk} prima di POSIX usava @code{OFMT} per
la conversione di stringhe
+@cartouche @command{awk} prima di POSIX usava @code{OFMT} per la conversione
di stringhe
@cindex POSIX @command{awk} @subentry @code{OFMT} (variabile)
@cindex @code{OFMT} (variabile)
@cindex portabilit@`a @subentry nuovo @command{awk} vs.@: vecchio @command{awk}
@@ -13422,7 +13444,7 @@ per separare la semantica della conversione dalla
semantica della stampa. Sia
@code{"%.6g"}. Nella stragrande maggioranza dei casi, i vecchi programmi di
@command{awk} non cambiano questo comportamento.
@xref{Print} per maggiori informazioni sull'istruzione @code{print}.
-@end sidebar
+@end cartouche
@node Localizzazione e conversioni
@subsubsection Le localizzazioni possono influire sulle conversioni
@@ -14038,7 +14060,8 @@ Soltanto l'operatore @samp{^=} @`e definito da POSIX.
Per avere la massima portabilit@`a, non usare l'operatore @samp{**=}.
@end quotation
-@sidebar Ambiguit@`a sintattiche tra @samp{/=} e le espressioni regolari
+@cindex riquadro @subentry Ambiguit@`a sintattiche tra @samp{/=} e le
espressioni regolari
+@cartouche Ambiguit@`a sintattiche tra @samp{/=} e le espressioni regolari
@cindex angolo buio @subentry costanti @dfn{regexp} @subentry operatore
@code{/=} e
@cindex @code{/} (barra) @subentry operatore @code{/=} @subentry vs.@:
costante @dfn{regexp} @code{/=@dots{}/}
@cindex barra (@code{/}) @subentry operatore @code{/=} @subentry vs.@:
costante @dfn{regexp} @code{/=@dots{}/}
@@ -14075,7 +14098,7 @@ awk '/[=]=/' /dev/null
@command{gawk} non ha questo problema, e neppure lo hanno BWK @command{awk}
e @command{mawk}.
-@end sidebar
+@end cartouche
@node Operatori di incremento
@subsection Operatori di incremento e di decremento
@@ -14164,7 +14187,8 @@ come valore dell'espressione.
@samp{@var{lvalue}++}, ma invece di aggiungere, sottrae.)
@end table
-@sidebar Ordine di valutazione degli operatori
+@cindex riquadro @subentry Ordine di valutazione degli operatori
+@cartouche Ordine di valutazione degli operatori
@cindex precedenza
@cindex operatori @subentry precedenza degli
@cindex portabilit@`a @subentry operatori
@@ -14206,7 +14230,7 @@ ogni cosa che possa incidere sulla portabilit@`a.
Si dovrebbero evitare cose come queste nei programmi.
@c You'll sleep better at night and be able to look at yourself
@c in the mirror in the morning.
-@end sidebar
+@end cartouche
@node Valori e condizioni di verit@`a
@section Valori e condizioni di verit@`a
@@ -16661,10 +16685,10 @@ per maggiori informazioni su questa versione del
ciclo @code{for}.
@subsection L'istruzione @code{switch}
@cindex @code{switch} (istruzione)
@cindex @code{case} @subentry parola chiave
-@cindex @code{case} @subentry @seealso{@code{switch} (istruzione)}
+@cindex @code{case} @seealso{@code{switch} (istruzione)}
@cindex parola @subentry chiave @code{case}
@cindex @code{default} @subentry parola chiave
-@cindex @code{default} @subentry @seealso{@code{switch} (istruzione)}
+@cindex @code{default} @seealso{@code{switch} (istruzione)}
@cindex parola @subentry chiave @code{default}
@ifnotinfo
@@ -18085,7 +18109,8 @@ elemento all'interno del vettore @code{SYMTAB}.
@end quotation
@end table
-@sidebar Modificare @code{NR} e @code{FNR}
+@cindex riquadro @subentry Modificare @code{NR} e @code{FNR}
+@cartouche Modificare @code{NR} e @code{FNR}
@cindex @code{NR} (variabile) @subentry modifica di
@cindex variabile @subentry @code{NR} @subentry modifica di
@cindex @code{FNR} (variabile) @subentry modifica di
@@ -18117,7 +18142,7 @@ Prima che @code{FNR} venisse aggiunto al linguaggio
@command{awk}
molti programmi @command{awk} usavano questa modalit@`a per
contare il numero di record in un file impostando a zero @code{NR} al cambiare
di @code{FILENAME}.
-@end sidebar
+@end cartouche
@node ARGC e ARGV
@subsection Usare @code{ARGC} e @code{ARGV}
@@ -21141,7 +21166,8 @@ in
@ref{FS rispetto a FPAT}.
@end itemize
-@sidebar Individuare la stringa nulla
+@cindex riquadro @subentry Individuare la stringa nulla
+@cartouche Individuare la stringa nulla
@cindex individuare @subentry la stringa nulla
@cindex stringa nulla @subentry individuare la
@cindex @code{*} (asterisco) @subentry operatore @code{*} @subentry
individuare la stringa nulla
@@ -21158,7 +21184,7 @@ $ @kbd{echo abc | awk '@{ gsub(/m*/, "X"); print @}'}
@noindent
Sebbene questo sia abbastanza sensato, pu@`o suscitare una certa sorpresa.
-@end sidebar
+@end cartouche
@node Dettagli ostici
@@ -21630,7 +21656,8 @@ in tal caso, @code{fflush()} restituisce ancora
@minus{}1.
@c end the table to let the sidebar take up the full width of the page.
@end table
-@sidebar Bufferizzazione interattiva e non interattiva
+@cindex riquadro @subentry Bufferizzazione interattiva e non interattiva
+@cartouche Bufferizzazione interattiva e non interattiva
@cindex bufferizzazione @subentry interattiva vs.@: non interattiva
A complicare ulteriormente le cose, i problemi di bufferizzazione possono
@@ -21675,7 +21702,7 @@ $ @kbd{awk '@{ print $1 + $2 @}' | cat}
In questo caso, nessun output viene stampato finch@'e non @`e stato battuto il
@kbd{Ctrl-d}, perch@'e l'output @`e bufferizzato e inviato tramite
@dfn{pipe} al comando @command{cat} in un colpo solo.
-@end sidebar
+@end cartouche
@table @asis
@item @code{system(@var{comando})}
@@ -21775,7 +21802,8 @@ in
A partire dalla versione di agosto 2018, BWK @command{awk} si comporta
come @command{gawk} per il codice di ritorno della chiamata @code{system()}.
-@sidebar Controllare la bufferizzazione dell'output con @code{system()}
+@cindex riquadro @subentry Controllare la bufferizzazione dell'output con
@code{system()}
+@cartouche Controllare la bufferizzazione dell'output con @code{system()}
@cindex buffer @subentry scrivere su disco un
@cindex bufferizzazione @subentry dell'input/output
@cindex output @subentry bufferizzazione
@@ -21836,14 +21864,14 @@ seconda riga stampata
Se @command{awk} non forzasse la scrittura dei suoi buffer prima di
invocare @code{system()}, l'output sarebbe quest'ultimo (quello non voluto).
-@end sidebar
+@end cartouche
@node Funzioni di tempo
@subsection Funzioni per gestire marcature temporali
@cindex funzioni @subentry di tempo
@cindex marcature temporali
-@cindex data e ora @subentry @seealso{marcature temporali}
+@cindex data e ora @seealso{marcature temporali}
@cindex @dfn{log} (registro) @subentry file di @subentry marcature temporali
nei
@cindex registro (@dfn{log}) @subentry file di @subentry marcature temporali
nel
@cindex file @subentry di registro (@dfn{log}) @subentry marcature temporali
nei
@@ -21969,7 +21997,7 @@ la lista che segue per le varie direttive di
formattazione.
@item @code{systime()}
@cindexgawkfunc{systime}
@cindex marcature temporali
-@cindex data e ora @subentry @seealso{marcature temporali}
+@cindex data e ora @seealso{marcature temporali}
@cindex data e ora @subentry corrente del sistema
Restituisce l'ora corrente come numero di secondi a partire dall'Epoca
del sistema. Sui sistemi aderenti allo standard POSIX, questo @`e il numero
@@ -22601,7 +22629,8 @@ i valori decimale e ottale dello stesso numero.
e poi mostra i risultati delle funzioni
@code{compl()}, @code{lshift()} e @code{rshift()}.
-@sidebar Attenzione. Non @`e tutto oro quel che luccica!
+@cindex riquadro @subentry Attenzione. Non @`e tutto oro quel che luccica!
+@cartouche Attenzione. Non @`e tutto oro quel che luccica!
In altri linguaggi, le operazioni "bit a bit" sono eseguite su valori interi,
non su valori in virgola mobile. Come regola generale, tali operazioni
@@ -22664,7 +22693,7 @@ In poche parole, usare @command{gawk} per qualsiasi
tipo di operazione
"bit a bit", tranne le pi@`u semplici, probabilmente @`e una cattiva idea;
@dfn{caveat emptor}!
-@end sidebar
+@end cartouche
@node Funzioni per i tipi
@subsection Funzioni per conoscere il tipo di una variabile
@@ -25733,14 +25762,15 @@ La
mostra come utilizzare questa funzione di libreria e come ci@`o
semplifichi la scrittura del programma principale.
-@sidebar Allora perch@'e @command{gawk} ha @code{BEGINFILE} e @code{ENDFILE}?
+@cindex riquadro @subentry Allora perch@'e @command{gawk} ha @code{BEGINFILE}
e @code{ENDFILE}?
+@cartouche Allora perch@'e @command{gawk} ha @code{BEGINFILE} e @code{ENDFILE}?
Ci si chieder@`a, probabilmente: perch@'e, se le funzioni @code{beginfile()} e
@code{endfile()} possono eseguire il compito, @command{gawk} prevede i
criteri di
ricerca @code{BEGINFILE} e @code{ENDFILE}?
-Buona domanda. Normalmente, se @command{awk} non riesce ad aprire un file,
+Bella domanda! Normalmente, se @command{awk} non riesce ad aprire un file,
questo fatto
provoca un errore fatale immediato. In tal caso, per una funzione definita
dall'utente non vi @`e alcun modo di affrontare il problema, giacch@'e la
@@ -25751,7 +25781,7 @@ Quindi, la ragione principale di @code{BEGINFILE} @`e
quella di dare un
@code{ENDFILE} esiste per simmetria, e perch@'e consente facilmente
una pulizia "file per file". Per maggiori informazioni si faccia
riferimento alla @ref{BEGINFILE/ENDFILE}.
-@end sidebar
+@end cartouche
@node Funzione rewind
@subsection Rileggere il file corrente
@@ -35930,7 +35960,7 @@ gawk>
@cindex comando del debugger @subentry @code{c} (alias per @code{continue})
@cindex comando del debugger @subentry @code{continue}
-@cindex continuare esecuzione programma @subentry nel debugger
+@cindex continuazione @subentry esecuzione programma nel debugger
@cindex debugger @subentry continuare esecuzione programma
@cindex @code{continue} (comando del debugger)
@item @code{continue} [@var{contatore}]
@@ -38446,7 +38476,8 @@ uniformemente, con la possibile conseguenza che errori
di arrotondamento
ripetuti tendono ad annullarsi a vicenda. Questa @`e la modalit@`a di
arrotondamento di default per funzioni e operatori di calcolo secondo IEEE 754.
@c January 2018. Thanks to nethox@gmail.com for the example.
-@sidebar Modalit@`a di arrotondamento e conversioni
+@cindex riquadro @subentry Modalit@`a di arrotondamento e conversioni
+@cartouche Modalit@`a di arrotondamento e conversioni
@`E importante comprendere che, insieme a @code{CONVFMT} e
@code{OFMT}, la modalit@`a di arrotondamento ha effetto anche sul
modo con cui i numeri sono convertiti in stringhe di caratteri.
@@ -38470,7 +38501,7 @@ $ @kbd{gawk -M -f roundmode.awk}
@print{} 3
@print{} 4
@end example
-@end sidebar
+@end cartouche
Le altre modalit@`a di arrotondamento sono usate raramente. Gli arrotondamenti
verso l'infinito (@code{roundTowardPositive}) e verso il meno infinito
@@ -42255,7 +42286,7 @@ insieme contiene informazioni su come @command{gawk}
@`e stato invocato.
* Versione dell'estensione:: Informazioni sulla versione API.
* Versione estensione GMP/MPFR:: Informazioni sulla versione disponibile
di GMP ed MPFR.
-* Variabili informative di estens. API:: Variabili che forniscono informationi
+* Variabili informative di estensione API :: Variabili che forniscono
informationi
sull'invocazione di @command{gawk}.
@end menu
@@ -42379,7 +42410,7 @@ in
chiama @code{check_mpfr_version()}.
@end table
-@node Variabili informative di estens. API
+@node Variabili informative di estensione API
@subsubsection Variabili informative
@cindex API (estensione) @subentry variabili informative
@cindex variabili @subentry informative dell'API
@@ -46167,7 +46198,7 @@ L'elemento di vettore @code{PROCINFO["CSV"]} esiste se
@command{gawk}
@item
La variabile informativa per l'API @code{do_csv}
-(@pxref{Variabili informative di estens. API}).
+(@pxref{Variabili informative di estensione API}).
@item
La possibilit@`a che @command{gawk} bufferizzi l'output a @dfn{pipe}
@@ -48281,7 +48312,8 @@ Per ulteriori informazioni, vedere (in inglese)
@cite{Fork My Code, Please!---An Open Letter To Those of You Who Are Unhappy}},
di Arnold Robbins e Chet Ramey.
-@sidebar Una nota riguardo a programmi @dfn{fuzzer}
+@cindex riquadro @subentry Una nota riguardo a programmi @dfn{fuzzer}
+@cartouche Una nota riguardo a programmi @dfn{fuzzer}
Negli ultimi anni, alcune persone hanno utilizzato dei programmi
di tipo ``fuzzer'' (programmi di test con input casuali) per generare
programmi @command{awk}, al fine di scoprire e segnalare (sedicenti)
@@ -48296,7 +48328,7 @@ Quindi, se si vuole eseguire un @dfn{fuzzer}
utilizzando @command{gawk}
e segnalare i risultati, si @`e liberi di farlo, ma si deve tener presente
che tali segnalazioni non hanno la stessa importanza delle segnalazioni
di reali bug in @command{gawk}.
-@end sidebar
+@end cartouche
@node Indirizzo bug
@appendixsubsec Segnalare bug
diff --git a/doc/it/gendocs.sh b/doc/it/gendocs.sh
index 11969c65..5fac4631 100755
--- a/doc/it/gendocs.sh
+++ b/doc/it/gendocs.sh
@@ -2,9 +2,9 @@
# gendocs.sh -- generate a GNU manual in many formats. This script is
# mentioned in maintain.texi. See the help message below for usage details.
-scriptversion=2022-10-25.23
+scriptversion=2023-07-12.10
-# Copyright 2003-2022 Free Software Foundation, Inc.
+# Copyright 2003-2023 Free Software Foundation, Inc.
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
@@ -55,7 +55,7 @@ unset use_texi2html
MANUAL_TITLE=
PACKAGE=
EMAIL=webmasters@gnu.org # please override with --email
-commonarg= # passed to all makeinfo/texi2html invcations.
+commonarg= # passed to all makeinfo/texi2html invocations.
dirargs= # passed to all tools (-I dir).
dirs= # -I directories.
htmlarg="--css-ref=https://www.gnu.org/software/gnulib/manual.css -c
TOP_NODE_UP_URL=/manual"
@@ -72,18 +72,22 @@ srcfile=
texarg="-t @finalout"
version="gendocs.sh $scriptversion
-Copyright 2022 Free Software Foundation, Inc.
+
+Copyright 2023 Free Software Foundation, Inc.
There is NO warranty. You may redistribute this software
under the terms of the GNU General Public License.
For more information about these matters, see the files named COPYING."
usage="Usage: $prog [OPTION]... PACKAGE MANUAL-TITLE
+
Generate output in various formats from PACKAGE.texinfo (or .texi or
.txi) source. See the GNU Maintainers document for a more extensive
discussion:
https://www.gnu.org/prep/maintain_toc.html
+
Options:
--email ADR use ADR as contact in generated web pages; always give this.
+
-s SRCFILE read Texinfo from SRCFILE, instead of PACKAGE.{texinfo|texi|txi}
-o OUTDIR write files into OUTDIR, instead of manual/.
-I DIR append DIR to the Texinfo search path.
@@ -98,44 +102,57 @@ Options:
--source ARG include ARG in tar archive of sources.
--split HOW make split HTML by node, section, chapter; default node.
--tex ARG pass ARG to texi2dvi for DVI and PDF, instead of -t @finalout.
+
--texi2html use texi2html to make HTML target, with all split versions.
--docbook convert through DocBook too (xml, txt, html, pdf).
+
--help display this help and exit successfully.
--version display version information and exit successfully.
+
Simple example: $prog --email bug-gnu-emacs@gnu.org emacs \"GNU Emacs Manual\"
+
Typical sequence:
cd PACKAGESOURCE/doc
wget \"$scripturl\"
wget \"$templateurl\"
$prog --email BUGLIST MANUAL \"GNU MANUAL - One-line description\"
+
Output will be in a new subdirectory \"manual\" (by default;
use -o OUTDIR to override). Move all the new files into your web CVS
tree, as explained in the Web Pages node of maintain.texi.
+
Please use the --email ADDRESS option so your own bug-reporting
address will be used in the generated HTML pages.
+
MANUAL-TITLE is included as part of the HTML <title> of the overall
manual/index.html file. It should include the name of the package being
documented. manual/index.html is created by substitution from the file
$GENDOCS_TEMPLATE_DIR/gendocs_template. (Feel free to modify the
generic template for your own purposes.)
+
If you have several manuals, you'll need to run this script several
times with different MANUAL values, specifying a different output
directory with -o each time. Then write (by hand) an overall index.html
with links to them all.
+
If a manual's Texinfo sources are spread across several directories,
first copy or symlink all Texinfo sources into a single directory.
(Part of the script's work is to make a tar.gz of the sources.)
+
As implied above, by default monolithic Info files are generated.
If you want split Info, or other Info options, use --info to override.
+
You can set the environment variables MAKEINFO, TEXI2DVI, TEXI2HTML,
and PERL to control the programs that get executed, and
GENDOCS_TEMPLATE_DIR to control where the gendocs_template file is
looked for. With --docbook, the environment variables DOCBOOK2HTML,
DOCBOOK2PDF, and DOCBOOK2TXT are also consulted.
+
By default, makeinfo and texi2dvi are run in the default (English)
locale, since that's the language of most Texinfo manuals. If you
happen to have a non-English manual and non-English web site, see the
SETLANG setting in the source.
+
Email bug reports or enhancement requests to bug-gnulib@gnu.org.
"
@@ -237,6 +254,7 @@ BEGIN {
}
" -e '
/<img src="(.*?)"/g && ++$need{$1};
+
END {
#print "$me: @{[keys %need]}\n"; # for debugging, show images found.
FILE: for my $f (keys %need) {
@@ -448,11 +466,25 @@ fi
# â
printf "\nMaking index.html for %s...\n" "$PACKAGE"
if test -z "$use_texi2html"; then
- CONDS="/%%IF *HTML_SECTION%%/,/%%ENDIF *HTML_SECTION%%/d;\
- /%%IF *HTML_CHAPTER%%/,/%%ENDIF *HTML_CHAPTER%%/d"
+ if test x$split = xnode; then
+ CONDS="/%%IF *HTML_NODE%%/d;/%%ENDIF *HTML_NODE%%/d;\
+ /%%IF *HTML_CHAPTER%%/,/%%ENDIF *HTML_CHAPTER%%/d;\
+ /%%IF *HTML_SECTION%%/,/%%ENDIF *HTML_SECTION%%/d;"
+ elif test x$split = xchapter; then
+ CONDS="/%%IF *HTML_CHAPTER%%/d;/%%ENDIF *HTML_CHAPTER%%/d;\
+ /%%IF *HTML_SECTION%%/,/%%ENDIF *HTML_SECTION%%/d;\
+ /%%IF *HTML_NODE%%/,/%%ENDIF *HTML_NODE%%/d;"
+ elif test x$split = xsection; then
+ CONDS="/%%IF *HTML_SECTION%%/d;/%%ENDIF *HTML_SECTION%%/d;\
+ /%%IF *HTML_CHAPTER%%/,/%%ENDIF *HTML_CHAPTER%%/d;\
+ /%%IF *HTML_NODE%%/,/%%ENDIF *HTML_NODE%%/d;"
+ else
+ CONDS="/%%IF.*%%/d;/%%ENDIF.*%%/d;" # invalid split argument
+ fi
else
- # should take account of --split here.
- CONDS="/%%ENDIF.*%%/d;/%%IF *HTML_SECTION%%/d;/%%IF *HTML_CHAPTER%%/d"
+ # for texi2html, we do not take account of --split and simply output
+ # all variants
+ CONDS="/%%IF.*%%/d;/%%ENDIF.*%%/d;"
fi
curdate=`$SETLANG date '+%B %d, %Y'`
diff --git a/doc/it/genera_formati.sh b/doc/it/genera_formati.sh
index 66540f2e..7ba8413a 100755
--- a/doc/it/genera_formati.sh
+++ b/doc/it/genera_formati.sh
@@ -2,12 +2,8 @@
# questo script, eseguito in questa directory
# genera tutti i formati della documentazione gawk
# che si possono ricavare a partire
-# da gawktexi.in, nella directory ./manual
+# da gawk.texi, nella directory ./manual
#
-# dapprima si prepara il file di input (gawk.texi)
-#
-awk -f sidebar.awk < gawktexi.in > gawk.texi
-#
-# poi si invoca lo script che genera i vari formati
+# si invoca lo script che genera i vari formati
#
./gendocs.sh gawk gawk
diff --git a/doc/it/sidebar.awk b/doc/it/sidebar.awk
deleted file mode 100644
index 4c0748e2..00000000
--- a/doc/it/sidebar.awk
+++ /dev/null
@@ -1,67 +0,0 @@
-# sidebar.awk --- add support for sidebars, other stuff to gawk.texi
-
-# Copyright (C) 2013, 2016 the Free Software Foundation, Inc.
-#
-# This file is part of GAWK, the GNU implementation of the
-# AWK Programming Language.
-#
-# GAWK is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 3 of the License, or
-# (at your option) any later version.
-#
-# GAWK is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
USA
-
-BEGIN {
- print "% ****************************************************"
- print "% * DO NOT MODIFY THIS FILE!!!! *"
- print "% * It was generated from gawktexi.in by sidebar.awk *"
- print "% * Edit gawktexi.in instead. *"
- print "% ****************************************************"
-}
-
-/^@sidebar/ {
- sub(/^@sidebar[ \t]+/, "", $0)
- title = $0
- body = ""
- collecting = 1
- next
-}
-
-/^@end[ \t]+sidebar[ \t]*$/ {
- collecting = 0
- printf "@cindex riquadro @subentry %s\n", title
- printf "@ifdocbook\n"
- printf "@docbook\n"
- printf "<sidebar><title>%s</title>\n", title
- printf "@end docbook\n"
- print body
- print ""
- printf "@docbook\n"
- printf "</sidebar>\n"
- printf "@end docbook\n"
- printf "@end ifdocbook\n\n"
-
- printf "@ifnotdocbook\n"
- printf "@cartouche\n"
- printf "@center @b{%s}\n\n", title
- print body
- printf "@end cartouche\n"
- printf "@end ifnotdocbook\n"
- body = ""
- next
-}
-
-collecting == 1 {
- body = body RS $0
- next
-}
-
-{ print }
-----------------------------------------------------------------------
Summary of changes:
doc/it/ChangeLog | 12 ++
doc/it/README.txt | 21 ++-
doc/it/{compila_originale.sh => compila_gawk.sh} | 4 -
doc/it/compila_smallprint.sh | 19 ---
doc/it/{gawktexi.in => gawk.texi} | 170 ++++++++++++++---------
doc/it/gendocs.sh | 48 +++++--
doc/it/genera_formati.sh | 8 +-
doc/it/sidebar.awk | 67 ---------
8 files changed, 163 insertions(+), 186 deletions(-)
mode change 100644 => 100755 doc/it/README.txt
rename doc/it/{compila_originale.sh => compila_gawk.sh} (80%)
delete mode 100755 doc/it/compila_smallprint.sh
rename doc/it/{gawktexi.in => gawk.texi} (99%)
delete mode 100644 doc/it/sidebar.awk
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [SCM] gawk branch, feature/docit, updated. gawk-4.1.0-5389-ga1a02e29,
Antonio Giovanni Colombo <=