starting to put tags, and a little cleanup

git-svn-id: svn://luxion/repos/thenautilus@374 fcb26f47-9200-0410-b104-b98ab5b095f3

10 files changed, 106 insertions, 354 deletions

diff --git a/SW/document.en.rest.txt b/SW/document.en.rest.txt
deleted file mode 100644
index 8baf700..0000000
--- a/SW/document.en.rest.txt
+++ /dev/null
@@ -1,42 +0,0 @@
-My software production
-======================
-
-`Web Generator`_
-
-    The system I use to generate this site
-
-`NNetLib`_
-
-    A C++ library to build and use neural networks (especially
-    back-propagation) with arbitrary (acyclic) topology.
-
-`Keyboard Layout`_
-
-    Some Perl scripts to (try to) optimize keyboard layout (very
-    experimental...)
-
-`KanaTrain`_
-
-    A Perl script to memorize japanese phonetic characters.
-
-`Installing QTopia today`_
-
-    How to develop for `Zaurus`_ without getting mad.
-
-.. _`keyboard layout`:
-    index/
-
-.. _`zaurus`:
-    zaurus/
-
-.. _`installing qtopia today`:
-    qtopia-dev/
-
-.. _`kanatrain`:
-    kanatrain/
-
-.. _`web generator`:
-    sitemake/
-
-.. _`nnetlib`:
-    http://sourceforge.net/projects/nnetlib/
diff --git a/SW/document.it.rest.txt b/SW/document.it.rest.txt
deleted file mode 100644
index a97ecd4..0000000
--- a/SW/document.it.rest.txt
+++ /dev/null
@@ -1,42 +0,0 @@
-La mia produzione software
-==========================
-
-`Generatore Web`_
-
-    Il metodo con cui genero questo sito
-
-`NNetLib`_
-
-    Libreria C++ per la gestione di reti neurali (specialmente
-    back-propagation) con topologia arbitraria (purché aciclica)
-
-`Keyboard Layout`_
-
-    Un paio di programmi Perl per (cercare di) ottimizzare il layout di
-    tastiera (molto sperimentale...)
-
-`KanaTrain`_
-
-    Un programma Perl per memorizzare i caratteri fonetici giapponesi
-
-`Installare QTopia oggi`_
-
-    Come sviluppare per lo `Zaurus`_ senza diventare matti
-
-.. _`keyboard layout`:
-    index/
-
-.. _`generatore web`:
-    sitemake/
-
-.. _`installare qtopia oggi`:
-    qtopia-dev/
-
-.. _`kanatrain`:
-    kanatrain/
-
-.. _`zaurus`:
-    zaurus/
-
-.. _`nnetlib`:
-    http://sourceforge.net/projects/nnetlib/
diff --git a/SW/kanatrain/document.en.rest.txt b/SW/kanatrain/document.en.rest.txt
index f348aca..40fe770 100644
--- a/SW/kanatrain/document.en.rest.txt
+++ b/SW/kanatrain/document.en.rest.txt
@@ -1,30 +1,30 @@
 KanaTrain
 =========
+:CreationDate: 2003-01-20 10:09:25
+:tags: - software
+       - japanese
 
-kanatrain.pl is a program to help memorize japanese phonetic characters, in
-particular hiragana (平仮名). It requires a Perl interpreter, version 5.6.0 or
-later (but it won't work with Perl 6) and a terminal capable of displaying
-glyphs specified with UTF-8. At the moment I know of only two programs capable
-of this: xterm as included in XFree86 4.x, and EMACS with `Mule-UCS`_ or
-`oc-unicode`_ packages.
+``kanatrain.pl`` is a program to help memorize japanese phonetic
+characters, in particular hiragana (平仮名). It requires a Perl
+interpreter, version 5.6.0 or later (but it won't work with Perl 6)
+and a terminal capable of displaying glyphs specified with UTF-8.
 
-The program contains two exercises: in the first one you're presented with a
-hiragana and you should write its pronounciation. To avoid ambiguities is best
-to write it after the *Kunrei* romanization (ち 'ti', し 'si', ぢ 'di') instead of
-the more common *Hepburn* (ち 'chi', し 'shi', ぢ 'ji'). If you make a mistake the
-correct pronounciation will be shown, along with the hiragana corresponding to
+The program contains two exercises: in the first one you're presented
+with a hiragana and you should write its pronounciation. To avoid
+ambiguities is best to write it after the *Kunrei* romanization (ち
+'ti', し 'si', ぢ 'di') instead of the more common *Hepburn* (ち
+'chi', し 'shi', ぢ 'ji'). If you make a mistake the correct
+pronounciation will be shown, along with the hiragana corresponding to
 the one you gave (if any).
 
-In the second exercise you're presented with a pronunciation (written after the
-*Kunrei* system) and five different hiragana characters, where only one is the
-right one. You should write the number relative to the right one. If you make a
-mistake the correct hiragana will be shown, along with the pronunication of the
-one you chose.
+In the second exercise you're presented with a pronunciation (written
+after the *Kunrei* system) and five different hiragana characters,
+where only one is the right one. You should write the number relative
+to the right one. If you make a mistake the correct hiragana will be
+shown, along with the pronunication of the one you chose.
 
 To end each exercise just give an empty answer.
 
-.. _`oc-unicode`:
-    http://www.cs.ruu.nl/~otfried/Mule/
+The source_ is a single file.
 
-.. _`mule-ucs`:
-    ftp://ftp.m17n.org/pub/mule/Mule-UCS/
+.. _source: /src/kana-train.pl
diff --git a/SW/kanatrain/document.it.rest.txt b/SW/kanatrain/document.it.rest.txt
index 572b6e9..cde9474 100644
--- a/SW/kanatrain/document.it.rest.txt
+++ b/SW/kanatrain/document.it.rest.txt
@@ -1,29 +1,30 @@
 KanaTrain
 =========
+:CreationDate: 2003-01-20 10:09:25
+:tags: - software
+       - japanese
 
-kanatrain.pl è un programma per aiutare a memorizzare i caratteri fonetici
-giapponesi, in particolare i hiragana (平仮名). Richiede un interprete Perl
-versione 5.6.0 o successive (ma non funzionerà col Perl 6) e un terminale
-capace di visualizzare caratteri in UTF-8. Al momento conosco solo due
-programmi in grado di farlo: xterm di XFree86 4.x, e EMACS con il pacchetto
-`Mule-UCS`_ o `oc-unicode`_ .
+``kanatrain.pl`` è un programma per aiutare a memorizzare i caratteri
+fonetici giapponesi, in particolare i hiragana (平仮名). Richiede un
+interprete Perl versione 5.6.0 o successive (ma non funzionerà col
+Perl 6) e un terminale capace di visualizzare caratteri in UTF-8.
 
-Il programma prevede due esercizi: nel primo viene mostrato un hiragana e
-bisogna inserirne la pronuncia. Per problemi di ambiguità è preferibile
-inserirla secondo la romanizazione *Kunrei* (ち 'ti', し 'si', ぢ 'di') piuttosto
-che la più comune *Hepburn* (ち 'chi', し 'shi', ぢ 'ji'). Quando si sbaglia viene
-mostrata la pronuncia corretta, e lo hiragana corrispondente alla pronuncia
-inserita (se esiste).
+Il programma prevede due esercizi: nel primo viene mostrato un
+hiragana e bisogna inserirne la pronuncia. Per problemi di ambiguità è
+preferibile inserirla secondo la romanizazione *Kunrei* (ち 'ti', し
+'si', ぢ 'di') piuttosto che la più comune *Hepburn* (ち 'chi', し
+'shi', ぢ 'ji'). Quando si sbaglia viene mostrata la pronuncia
+corretta, e lo hiragana corrispondente alla pronuncia inserita (se
+esiste).
 
-Nel secondo esercizio viene proposta una pronuncia (scritta secondo il sistema
-*Kunrei*) e cinque scelte di hiragana diversi, di cui solo uno è giusto.
-Bisogna inserire il numero corrispondente a quello giusto. Se si sbaglia, viene
-mostrato lo hiragana giusto e la pronuncia di quello scelto.
+Nel secondo esercizio viene proposta una pronuncia (scritta secondo il
+sistema *Kunrei*) e cinque scelte di hiragana diversi, di cui solo uno
+è giusto.  Bisogna inserire il numero corrispondente a quello
+giusto. Se si sbaglia, viene mostrato lo hiragana giusto e la
+pronuncia di quello scelto.
 
 Per terminare ciascun esercizio basta dare una risposta vuota.
 
-.. _`oc-unicode`:
-    http://www.cs.ruu.nl/~otfried/Mule/
+Il sorgente_ è un singolo file.
 
-.. _`mule-ucs`:
-    ftp://ftp.m17n.org/pub/mule/Mule-UCS/
+.. _sorgente: /src/kana-train.pl
diff --git a/SW/kblayout/document.en.rest.txt b/SW/kblayout/document.en.rest.txt
new file mode 100644
index 0000000..69c46c0
--- /dev/null
+++ b/SW/kblayout/document.en.rest.txt
diff --git a/SW/kblayout/document.it.rest.txt b/SW/kblayout/document.it.rest.txt
new file mode 100644
index 0000000..6785260
--- /dev/null
+++ b/SW/kblayout/document.it.rest.txt
@@ -0,0 +1,65 @@
+Migliorare il layout di tastiera
+================================
+:CreationDate: 2003-01-28 10:09:25
+:tags: - software
+       - keyboard
+
+Conoscerete anche voi la storia della tastiera Sholes ("QWERTY"), che
+è stata inventata per evitare che i dattilografi troppo veloci
+facessero inceppare i martelletti delle macchine per scrivere
+meccaniche. Saprete anche che il layout Dvorak è da molti considerato
+più efficace e veloce.
+
+Quando provai a imparare a usare la tastiera Dvorak, un mio amico mi
+disse pressappoco: «Perché non scrivi un programma che misuri l'uso
+che fai tu della tastiera, e ricavi un layout personalizzato?». In un
+momento di follia, ho deciso di farlo davvero.
+
+Il primo programma è ``freq.pl``_, che legge i file dati a riga di
+comando e calcola una matrice di probabilità (nel file il cui nome è
+nella variabile ``$MATRFN``, al momento ``/tmp/freq.matr``). In
+effetti tratta il testo come un processo di Markov sui caratteri a
+memoria 1, e ricava la matrice di transizione. Nota: gli elementi sono
+frequenze, non probabilità. L'eventuale normalizzazione è lasciata
+come esercizio al lettore.
+
+Il secondo programma è ``freqdump.pl``_, che probabilmente non serve a
+niente. L'ho scritto (tre o quattro versioni diverse) per avere
+un'idea di come fossero le frequenze. Dateci un'occhiata se volete.
+
+Il programma più utile (spero) è ``optkeyb.pl``_, che parte dalla
+matrice (al solito, nome di file hardcoded) e dal layout QWERTY
+cercando per discesa di gradiente stocastica un layout migliore. In
+parole povere, calcola un valore per il layout (somma sulle coppie di
+tasti della distanza per la frequenza), poi prova a scambiare due
+tasti a caso e vedere se il risultato è migliore. Per aggirare i
+minimi locali (e ce ne sono tanti) all'inzio scambia a caso
+``$PRE_SHUFFLE`` volte, e se per ``$STARVATION`` tentativi non ha
+trovato un miglioramento ricomincia, dopo aver appeso il layout
+localmente ottimo al file ``/tmp/layouts``. Usa le curses e il
+corrispondente modulo Perl ``Curses.pm``.
+
+Per evitare cose brutte (i.e. i numeri a spasso) nell'hash ``%locked``
+è possibile impostare i tasti che non si vogliono spostare.
+
+Per dare un'idea dei risultati, dopo qualche ora di calcoli il miglior
+layout era:
+
+::
+    ` 1 2 3 4 5 6 7 8 9 0 ; =
+       - x w h t s a l b y ' j q
+       z \ [ c i e r u p . ,
+        k v f d n o m g ] /
+
+Tenete conto che io uso una tastiera IBM U.S., e dove è finita la
+``q`` c'era il tasto pipe/backslash (che è più largo degli altri, e
+quindi avrei dovuto bloccarlo...)
+
+Per dare un'idea del miglioramento, il valore calcolato per la QWERTY
+è 10.190.280, per quella riportata sopra è 6.797.370, che si traduce
+in una riduzione del 34% del chilometraggio delle dita durante la
+battitura.
+
+.. _`freq.pl`: /src/freq.pl
+.. _`freqdump.pl`: /src/freqdump.pl
+.. _`optkeyb.pl`: /src/optkeyb.pl
diff --git a/SW/kblayout/index/document.en.rest.txt b/SW/kblayout/index/document.en.rest.txt
deleted file mode 100644
index e56d458..0000000
--- a/SW/kblayout/index/document.en.rest.txt
+++ /dev/null
@@ -1,59 +0,0 @@
-Optimize keyboard layout
-========================
-
-I'm sure you, too, know the history of the QWERTY keyboard, that was designed
-to avoid that too fast typists jammed mechanical typewriters. You would know
-also that the Dvorak layout is cosidered by many to be faster and more
-effective.
-
-When I tried to learn to use the Dvorak keyboard, a friend of mine asked me Why
-don't you write a program to measure your keyboard usage, and then obtain a
-personalized layout?. In a moment of crazyness, I decided to do just that.
-
-The first program is freq.pl, which reads the files given on the command line
-and produces a probability matrix, writing it into the file whose name is in
-the $MATRFN variable, default /tmp/freq.matr. Actually it sees the text as a
-Markov process over the characters with memory 1, and extracts the transition
-matrix. Note: the elements are frequencies, not probabilities. The optional
-normalization is left as exercise to the reader.
-
-The second program is freqdump.pl, which is probably useless. I've written it
-(three or four different versions) to have an idea about the frequencies. Give
-it a look if you want.
-
-The most useful program (I hope) is optkeyb.pl, which starting from the matrix
-(as usual, filename hardcoded) and the QWERTY layout searches by stochastic
-gradient descent a better layout. In other words, it calculates a value for the
-layout (sum over the pairs of keys of their distance times the frequency of
-that pair), then tries to exchange two random keys looking for a better result.
-To avoid local minima (there are a lot) it starts by randomly exchanging
-$PRE_SHUFFLE pairs, and if it doesn't find a better layout for $STARVATION
-tries it starts again, after having written the locally optimum layout at the
-end of the file /tmp/layouts. It uses curses and the corresponding Perl module
-Curses.pm.
-
-To avoid bad things, like numbers scattered between other keys, it's possible
-to set into the %locked hash the keys that must not be moved.
-
-To give yoy an idea of the results, after some hours of computation the best
-layout was:
-
-::
-
-    
-    ` 1 2 3 4 5 6 7 8 9 0 ; =
-       - x w h t s a l b y ' j q
-       z \ [ c i e r u p . ,
-        k v f d n o m g ] /
-    
-..
-
-
-
-Bear in mind I use a IBM U.S. keyboard, and where the q is, there's usally the
-backslash/pipe key, which is larger than the others, so I should have locked
-it...
-
-To have an idea of the optimization, the value relative to the QWERTY layout is
-10.190.280, for the one above is 6.797.370, meaning a 34% reduction in the
-space travelled by the fingers during writing.
diff --git a/SW/kblayout/index/document.it.rest.txt b/SW/kblayout/index/document.it.rest.txt
deleted file mode 100644
index f710e29..0000000
--- a/SW/kblayout/index/document.it.rest.txt
+++ /dev/null
@@ -1,59 +0,0 @@
-Migliorare il layout di tastiera
-================================
-
-Conoscerete anche voi la storia della tastiera QWERTY, che è stata inventata
-per evitare che i dattilografi troppo veloci facessero inceppare i martelletti
-delle macchine per scrivere meccaniche. Saprete anche che il layout Dvorak è da
-molti considerato più efficace e veloce.
-
-Quando provai a imparare a usare la tastiera Dvorak, un mio amico mi disse
-pressappoco Perché non scrivi un programma che misuri l'uso che fai tu della
-tastiera, e ricavi un layout personalizzato?. In un momento di follia, ho
-deciso di farlo davvero.
-
-Il primo programma è freq.pl, che legge i file dati a riga di comando e calcola
-una matrice di probabilità (nel file il cui nome è nella variabile $MATRFN, al
-momento /tmp/freq.matr). In effetti tratta il testo come un processo di Markov
-sui caratteri a memoria 1, e ricava la matrice di transizione. Nota: gli
-elementi sono frequenze, non probabilità. L'eventuale normalizzazione è
-lasciata come esercizio al lettore.
-
-Il secondo programma è freqdump.pl, che probabilmente non serve a niente. L'ho
-scritto (tre o quattro versioni diverse) per avere un'idea di come fossero le
-frequenze. Dateci un'occhiata se volete.
-
-Il programma più utile (spero) è optkeyb.pl, che parte dalla matrice (al
-solito, nome di file hardcoded) e dal layout QWERTY cercando per discesa di
-gradiente stocastica un layout migliore. In parole povere, calcola un valore
-per il layout (somma sulle coppie di tasti della distanza per la frequenza),
-poi prova a scambiare due tasti a caso e vedere se il risultato è migliore. Per
-aggirare i minimi locali (e ce ne sono tanti) all'inzio scambia a caso
-$PRE_SHUFFLE volte, e se per $STARVATION tentativi non ha trovato un
-miglioramento ricomincia, dopo aver appeso il layout localmente ottimo al file
-/tmp/layouts. Usa le curses e il corrispondente modulo Perl Curses.pm.
-
-Per evitare cose brutte (i.e. i numeri a spasso) nell'hash %locked è possibile
-impostare i tasti che non si vogliono spostare.
-
-Per dare un'idea dei risultati, dopo qualche ora di calcoli il miglior layout
-era:
-
-::
-
-    
-    ` 1 2 3 4 5 6 7 8 9 0 ; =
-       - x w h t s a l b y ' j q
-       z \ [ c i e r u p . ,
-        k v f d n o m g ] /
-    
-..
-
-
-
-Tenete conto che io uso una tastiera IBM U.S., e dove è finita la q c'era il
-tasto pipe/backslash (che è più largo degli altri, e quindi avrei dovuto
-bloccarlo...)
-
-Per dare un'idea del miglioramento, il valore calcolato per la QWERTY è
-10.190.280, per quella riportata sopra è 6.797.370, che si traduce in una
-riduzione del 34% del chilometraggio delle dita durante la battitura.
diff --git a/SW/sitemake/document.en.rest.txt b/SW/sitemake/document.en.rest.txt
deleted file mode 100644
index c947412..0000000
--- a/SW/sitemake/document.en.rest.txt
+++ /dev/null
@@ -1,55 +0,0 @@
-Web Generator
-=============
-
-Motivations
------------
-
-Ever since I discovered `XML`_ and `XSLT`_, I've been looking for an easy and
-confortable way to keep content and presentation totally separate. I started
-using `XWeb`_, which is a good program, but with some problems:
-
-*   it's written in Java (OK, OK, this is personal taste)
-
-*   it "tweaks" files to add (navigational) information, and I thought it was
-    not necessary
-
-*   it does (did?) not have dependency control functionalities (like make)
-
-Shortly after version 0.3 I lost sync with the official codebase because of
-some modifications of mine, and I did not follow later developments.
-
-Given the high level of correctness attained by the `Gnome XSLT library`_, I
-decided to try and look if it was possible to use just xsltproc and make to
-obtain the same results.
-
-So I developed a DTD to describe the structure of the site, a stylesheet to
-convert this structure into a makefile, and retouched the stylesheets to keep
-them working after the modifications.
-
-How it works
-------------
-
-Given a description of the site's structure in the file sitemap.xml, the
-stylesheet compile.xsl generates a Makefile containing rules for the
-transformation of every page, along with their prerequisites.
-
-In this way calling make causes the regenaration of only those files whose
-source have actually been modified. Moreover, each stylesheet implicitly gets
-two parameters: sitemapuri containing the URI of the sitemap relative to the
-stylesheet, and active which is an XPath expression indicating, inside the
-sitemap, the node corresponding to the page being transformed. This way the
-stylesheets can access all relevant navigational information.
-
-You can consult the site's sources.
-
-.. _`xml`:
-    http://www.w3.org/TR/REC-xml
-
-.. _`gnome xslt library`:
-    http://xmlsoft.org/XSLT
-
-.. _`xweb`:
-    http://xweb.sourceforge.net
-
-.. _`xslt`:
-    http://www.w3.org/TR/xslt
diff --git a/SW/sitemake/document.it.rest.txt b/SW/sitemake/document.it.rest.txt
deleted file mode 100644
index dd842b3..0000000
--- a/SW/sitemake/document.it.rest.txt
+++ /dev/null
@@ -1,57 +0,0 @@
-Generatore Web
-==============
-
-Le motivazioni
---------------
-
-Da quando ho scoperto `XML`_ e `XSLT`_, ho cercato un modo semplice e comodo
-per gestire in maniera del tutto separata contenuto e presentazione. All'inizio
-usavo `XWeb`_, ottimo programma, ma con alcuni difetti:
-
-*   è scritto in Java (OK, OK, questa è una questione personale...)
-
-*   "trucca" i file per aggiungervi informazioni (di navigazione), e io pensavo
-    non fosse necessario
-
-*   non ha (aveva?) funzionalità di controllo dipendenze (tipo make)
-
-Poco dopo la versione 0.3 ho perso la sincronizzazione con la codebase
-ufficiale a causa di qualche mia modifica al codice, e non ne ho più seguiti
-gli sviluppi.
-
-Dato l'ottimo livello di correttezza raggiunto dalla `libreria Gnome XSLT`_, ho
-deciso di vedere se fosse possibile usare soltanto xsltproc e make per ottenere
-gli stessi effetti.
-
-Ho quindi sviluppato un DTD per descrivere la struttura del sito, uno
-stylesheet per convertire questa struttura in un makefile, e ho ritoccato gli
-stylesheet per adeguarli alle modifiche.
-
-Funzionamento
--------------
-
-Data una descrizione della struttura del sito, nel file sitemap.xml, lo
-stylesheet compile.xsl genera un Makefile contenente le istruzioni per la
-trasformazione di tutte le pagine, e i loro prerequisiti.
-
-In questo modo, chiamando make vengono rigenerati soltanto i file i cui
-sorgenti sono stati effettivamente modificati. Inoltre, ad ogni stylesheet
-vengono passati implicitamente due parametri: sitemapuri che indica la URI
-della sitemap relativa allo stylesheet, e active che è un'espressione XPath che
-identifica, dentro la sitemap, il nodo corrispondente alla pagina che si sta
-trasformando. In questo modo gli stylesheet possono accedere a tutte le
-informazioni di navigazione utili.
-
-Potete consultare i sorgenti del sito.
-
-.. _`xml`:
-    http://www.w3.org/TR/REC-xml
-
-.. _`libreria gnome xslt`:
-    http://xmlsoft.org/XSLT
-
-.. _`xweb`:
-    http://xweb.sourceforge.net
-
-.. _`xslt`:
-    http://www.w3.org/TR/xslt