6 999
contributi
Creare un pacchetto deb contenente script personali: differenze tra le versioni
Creare un pacchetto deb contenente script personali (visualizza wikitesto)
Versione delle 00:44, 23 nov 2014
, 23 nov 2014+ paragrafo "Manpage del pacchetto"
S3v (discussione | contributi) |
S3v (discussione | contributi) (+ paragrafo "Manpage del pacchetto") |
||
| Riga 458: | Riga 458: | ||
; /usr/local/bin/imieiscript/ | ; /usr/local/bin/imieiscript/ | ||
:è necessario fare in modo che questa directory sia inclusa nel proprio path aggiungendo al file "~/.bashrc" la riga:<pre>export PATH=$PATH:/usr/local/bin/imieiscript</pre> e impartire un:<pre>$ source ~/.bashrc</pre> per rendere effettive le modifiche. | :è necessario fare in modo che questa directory sia inclusa nel proprio path aggiungendo al file "~/.bashrc" la riga:<pre>export PATH=$PATH:/usr/local/bin/imieiscript</pre> e impartire un:<pre>$ source ~/.bashrc</pre> per rendere effettive le modifiche. | ||
== Manpage del pacchetto == | |||
L'esistenza di una [[manpage]] per il pacchetto non è fondamentale ma potrebbe rivelarsi utile per almeno tre buoni motivi: | |||
* Gli script potrebbero essere utilizzati anche da altre persone che vorrebbero, giustamente, capire cosa sono e come utilizzarli. | |||
* Conoscere rapidamente la versione del pacchetto. | |||
* Conoscere rapidamente quanti e quali script sono disponibili. | |||
=== Pacchetti necessari === | |||
Installeremo il comodo "txt2man" che permette la conversione di un normale file di testo in un secondo file con formato proprio di una manpage (troff). | |||
<pre> | |||
# apt-get install txt2man | |||
</pre> | |||
=== Creazione della manpage === | |||
Creare nella directory "debian" un file di testo "imieiscript.manpage.txt" e inserirvi: | |||
<pre> | |||
NAME | |||
imieiscript - i miei script personali | |||
DESCRIZIONE | |||
Questo pacchetto contiene i miei script personali installati nella directory /usr/local/bin/imieiscript | |||
LISTA DEGLI SCRIPT | |||
script1 script che mostra a video "Hello world!" | |||
script2 script che cancella il file /tmp/pippo | |||
script3 script che crea il file /home/pippo/myfile | |||
Leggere il contenuto iniziale degli script o eseguirli con l'opzione --help per ottenere maggiori informazioni sul loro utilizzo. | |||
</pre> | |||
Successivamente bisogna convertire questo file: | |||
<pre> | |||
$ txt2man -v "versione 1.0" -s 1 -t IMIEISCRIPT imieiscript.manpage.txt > imiescript.manpage | |||
</pre> | |||
per ottenere il file <code>imieiscript.manpage</code> in formato troff.<br/> | |||
Notare l'opzione '-v "versione 1.0"' che può essere omessa oppure modificata in base alla versione del pacchetto che si sta costruendo.<br/> | |||
Si rimanda alla manpage di "txt2man" per maggiori informazioni sulla sintassi e i parametri utilizzati. | |||
Prima di proseguire con la costruzione del pacchetto, è opportuno eseguire il comando: | |||
<pre> | |||
$ man -l imieiscript.manpage | |||
</pre> | |||
per visualizzare la manpage generata. | |||
Il passo finale consiste nella creazione, all'interno della directory "debian", del file "manpages" contenente: | |||
<pre> | |||
debian/imieiscript.manpage | |||
</pre> | |||
Dopo la costruzione e installazione del pacchetto sarà possibile visualizzare la manpage nel consueto modo: | |||
<pre> | |||
$ man imieiscript | |||
</pre> | |||
{{Box|Nota|Benché sia possibile cancellare il file di testo "imieiscript.manpage.txt", è consigliabile mantenerlo al suo posto in caso di future modifiche della manpage.}} | |||
{{Autori | {{Autori | ||