xref: /linux/Documentation/translations/it_IT/doc-guide/checktransupdate.rst (revision 72fdff1416e280e2baaa3cca69574defb998437e)
1.. SPDX-License-Identifier: GPL-2.0
2
3.. include:: ../disclaimer-ita.rst
4
5Verificare la necessità di aggiornare le traduzioni
6===================================================
7
8Questo script aiuta a tracciare lo stato delle traduzioni della
9documentazione nelle diverse lingue, ovvero se la documentazione è
10allineata con la controparte inglese.
11
12Come funziona
13-------------
14
15Lo script usa il comando ``git log`` per individuare l'ultimo commit in inglese
16a partire dal commit della traduzione (in ordine di data dell'autore) e gli
17ultimi commit in inglese a partire da HEAD. Se emergono delle differenze, il
18file viene considerato non aggiornato, e vengono quindi raccolti e segnalati i
19commit che necessitano di un aggiornamento.
20
21Funzionalità implementate
22
23-  verifica di tutti i file in una determinata lingua
24-  verifica di un singolo file o di un insieme di file
25-  opzioni per modificare il formato dell'output
26-  tracciamento dello stato di traduzione dei file che non hanno alcuna
27   traduzione
28
29Utilizzo
30--------
31
32::
33
34   tools/docs/checktransupdate.py --help
35
36Fate riferimento all'output del messaggio d'aiuto per i dettagli sull'utilizzo.
37
38Esempi
39
40-  ``tools/docs/checktransupdate.py -l zh_CN``
41   Questo stamperà tutti i file che necessitano di un aggiornamento nella
42   lingua zh_CN.
43-  ``tools/docs/checktransupdate.py Documentation/translations/zh_CN/dev-tools/testing-overview.rst``
44   Questo stamperà solamente lo stato del file specificato.
45
46L'output sarà quindi qualcosa del genere:
47
48::
49
50    Documentation/dev-tools/kfence.rst
51    No translation in the locale of zh_CN
52
53    Documentation/translations/zh_CN/dev-tools/testing-overview.rst
54    commit 42fb9cfd5b18 ("Documentation: dev-tools: Add link to RV docs")
55    1 commits needs resolving in total
56
57Funzionalità ancora da implementare
58
59- specificare cartelle in aggiunta ai singoli file
60