
Algemeen conversie rekenprogramma voor de Psion Series 3a
                   Versie 1.0

          Copyright (c) 1994 M.D. Nijdam

Email: marco@west.nl
Adres: Kerklaan 7c
       NL-2283 CM  Rijswijk
       Nederland

======================================================================
Inhoudsopgave
----------------------------------------------------------------------

Voorbehoud
Het programma en de naam
Inleiding
    Voordelen boven andere conversie programma's
    Nadelen ten opzichte van andere tools
Gebruik van het programma
    Om te beginnen
    In het programma
Andere mogelijkheden
    Veranderen van de database
    Berekeningen uitvoeren
    Veranderen van de weergave precisie
    Veranderen van de getal notatie
    Bewaren van voorkeuren als instelling bij het starten
    Gebruik van een getal uit een Calc geheugen
    Bewaren van getal in Calc geheugen
    Tips
    Buitennissigheden
Veranderen van de database
    Database specificatie
    Categorien invoeren
    Standaard instellingen (defaults)
    Beperkingen
Vertalingen
    Internationalisatie
    Vertalen van de help file
    Tips
OPL code
    Vertalen
    Hergebruik
Ten slotte: Hou me op de hoogte

======================================================================
Voorbehoud
----------------------------------------------------------------------

Dit programma is vrije software; je mag het verspreiden en/of wijzigen
onder de voorwaarden van de GNU General Public License zoals door de
Free Software Foundation gepubliceerd; versie 1, of (naar keuze) een
latere versie.
Dit programma wordt verspreid in de hoop dat het nuttig zal zijn,
maar ABSOLUUT ZONDER GARANTIE; zelfs zonder de impliciete garantie
van VERKOOPBAARHEID of GESCHIKTHEID VOOR EEN BEPAALD DOEL. Zie de
GNU General Public License voor meer details.

Tezamen met dit programma moet je een kopie van de GNU General Public
License hebben ontvangen; zo niet, schrijf dan naar de Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

======================================================================
Het programma en de naam
----------------------------------------------------------------------

JAICNV is een afkorting voor "JAI convert". Het is een algemeen conversie
programma voor de Psion 3a, dat de conversie van een getal van n
eenheid in een andere berekent. Het is algemeen omdat de conversie
regels in een database staan, die met het standaard Data programma
op de Psion 3a kunnen worden gewijzigd. Je kan eenvoudig nieuwe
conversies toevoegen. Meer hierover verderop in dit document.

JAI is de afkorting van "Just An Idea", of wel "zomaar een idee".
In het Frans (geschreven als J'ai) betekent het ook "Ik heb", of
in het Engels "I have", wat je misschien herinnert aan de beroemde
toespraak van Martin Luther King: "I have a dream". In mijn geval
betekent het ook "Ik heb een idee".

======================================================================
Inleiding
----------------------------------------------------------------------

Oh nee, niet nog een conversie programma! Is het beter dan de andere
honderd die ik heb gezien?

Natuurlijk ben ik van mening dat dat het geval is. Hoewel het in het
gebruik eenvoudig is, zijn de mogelijkheden van dit programma eindeloos.
JAICNV kan elk getal omzetten in elk ander, als er maar een formule
is om dat te doen.

      Om maar eens een paar mogelijkheden te noemen:
      - Omzetten van elke lengtemaat naar elke andere: inches, meters,
        kilometers, yards, miles, parsecs, etc. etc.
      - Idem voor oppervlakte-, en volumematen, massa en snelheid.
      - Omrekenen van temperatuur, zelfs van Celcius naar Fahrenheit,
        hoewel dat met een formule moet en niet met een factor.
      - Munteenheden omrekenen voor elke munteenheid.
      - Je kan zelf je favoriete formules met n, of met een truc
        zelfs enkele, variabelen in dit programma zetten.

Bij dit programma heb ik een database met vele eenheden in bovenstaande
categorien gevoegd. En het is eenvoudig om zelf nieuwe toe te voegen,
of bestaande te wijzigen. Dat laatste is vooral belangrijk bij
munteenheden, omdat de wisselkoersen bijna dagelijks veranderen.

En dat is nog niet alles. Het is mogelijk om de geheugens van de
Psion Calc tool direct (of indirect) te gebruiken, en om berekende
waarden weer in een Calc geheugen op te slaan. Daarmee is het tevens
mogelijk getallen naar andere programma's, zoals Word, Data en Sheet
te kopiren.

Voordelen boven andere conversie programma's
=====================================================================

    - Dit is vrije software.
    - De programma code wordt meegeleverd.
    - Alles kan veranderd worden.
    - Het gebruikers interface kan in verschillende talen worden
      vertaald, zonder dat de programma code veranderd hoeft te
      worden.
    - Het kan vele conversie regels aan in n database, die
      eenvoudig door de gebruiker kunnen worden ingevoerd.
      Maar het kan ook meerdere databases aan.
    - Conversies zijn gesplitst per categorie, voor eenvoudige
      selectie.
    - Conversies die niet nodig zijn kunnen eenvoudig worden
      verwijderd, om geheugen te sparen.
    - Interface met Calc tool in twee richtingen.
    - Het is zelf ook een calculator die expressies met functies
      kan uitrekenen.

Nadelen ten opzichte van andere tools
=====================================================================

    - Dit is vrije software.
    - Geen garantie, geen ondersteuning.
    - Alles kan veranderd worden.

======================================================================
Gebruik van het programma
----------------------------------------------------------------------

Om te beginnen
======================================================================

Kopieer de volgende files:

     jaicnv.opa     naar \app directory
     jaicnvnl.dbf   naar \dat directory
     jaicnvnl.hlp   naar \dat directory

Installeer het programma met de Installeer optie uit het Apps menu
op het systeem scherm.

Start het programma door het icoon voor het programma te selecteren
en op Enter te drukken.

Een alternatief is om de OPL code te veranderen zodat het in een OPO
kan worden gecompileerd, door de APP definitie weg te halen.


In het programma
======================================================================

Nadat het programma gestart is zie je het voorbehoud. Druk op Enter
om naar het openingsscherm te gaan. Van hieruit kun je Help opvragen,
via het menu een aantal acties ondernemen, of naar het hoofdscherm
gaan door op Enter te drukken.

Vanaf het hoofdscherm kan je weer naar het openingsscherm terug door
op Esc te drukken.

Op het hoofdscherm kan je de categorie en de eenheden uitkiezen,
en de om te zetten waarden invoeren. Telkens als je een wijziging
maakt moet je op de Enter toets drukken. Het is belangrijk in wel
veld je op Enter drukt. Als je bijv. in het veld voor de "van" waarde
op Enter drukt wordt de "Naar" waarde berekend. Druk je op Enter in
het veld voor de "Naar" waarde dan wordt de "Van" waarde berekent.

      De namen "Van" en "Naar" zijn dus eigenlijk wat misleidend,
      omdat je (meestal) in beide richtingen kan omzetten.
      Een reden om ze toch te gebruiken is dat in een incomplete
      database niet alle conversies in twee richtingen hoeven te zijn.

Bij de start zijn sommige velden niet toegankelijk. Als je een
categorie uitzoekt en op Enter drukt in het categorie veld worden
de velden voor de eenheden toegankelijk. Als je de eenheden uitzoekt
en in n van de eenheid velden op Enter drukt worden de velden voor
de waarden toegankelijk. Als je later de categorie veranderd kan het
voorkomen dat sommige velden weer worden beschermd.

Samenvatting: Druk op Enter, en nog eens, en weer, en weer...


======================================================================
Andere mogelijkheden
----------------------------------------------------------------------

Veranderen van de database
======================================================================

Standaard wordt de eerste database met een filenaam die voldoet aan
"\dat\jaicnv*.dbf" gebruikt. Je kan echter een andere database
uitkiezen. Hoe je zo'n database maakt wordt verderop beschreven.

Om de database te veranderen moet je naar het hoofdscherm gaan
(vanaf het opening scherm druk je op Enter). Het laatst punt
op het hoofdscherm gebruik je om een (database) file uit te zoeken.
Druk op Enter in het filenaam veld om de geselecteerde database
te openen.

Het veld werkt zoals velden om files te selecteren in andere Psion
applicaties. Dus door op Tab te drukken kan je meer gedetailleerd
de gewenste file uitzoeken.

Kijk ook eens in de sectie over "internationalisatie" elders in
dit document.


Berekeningen uitvoeren
======================================================================

In de waarde velden kan je niet alleen waarden invoeren, maar ook
expressies. Je bent slechts beperkt door de lengte van een regel.
Als je op Enter drukt in een veld met een expressie, wordt eerst
de waarde van de expressie berekent, en daarmee de waarde voor het
andere veld, gebruik makend van de conversie formule. Om de waarde
van de expressie zelf te zien moet je dan wel de zelfde Van en Naar
eenheid gebruiken, of eerst de andere waarde laten berekenen, zoals
hierboven geschreven, en dan in het andere waarde veld op Enter
drukken.

Er wordt een fout gegeven als de expressie niet correct is.

Elke OPL expressie kan gebruikt worden. Dit betekent dat je gebruik
kunt maken van +, -, *, /, **, %, (, ), OPL functies (zoals sin(),
cos(), tan(), pi, ln(), exp(), ja zelfs rnd), Calc geheugens (M0 to M9),
hexadecimale getallen (bijv. $0D), etc.


Veranderen van de weergave precisie
======================================================================

In het begin toont JAICNV waarden met 20 cijfers.
Je kan zowel het aantal decimalen als de maximale breedte van
berekende waarden veranderen. Vanaf het opening scherm druk je op de
Menu toets en kies je van het "Speciaal" menu de optie "Voorkeuren".
Verander de "Maximale breedte" zoals je wilt en druk op Enter om
het vast te leggen.

In de volgende sectie wordt ook het getal formaat besproken.


Veranderen van de getal notatie
======================================================================

Bij de voorkeuren (zie Veranderen van weergave precisie) kun je
ook de notatie van getallen veranderen. Kies voor

- wetenschappelijk      : Wetenschappelijk formaat, met mantissa en
                          exponent. In dit geval kan je ook het aantal
                          decimalen aangeven.
- Vast aantal decimalen : Het getal wordt getoond met het aantal
                          opgegeven decimalen.
- Optimaal              : Gebruikt vast aantal decimalen als dat
                          mogelijk is, anders wetenschappelijk. Dit
                          is de instelling bij het eerste starten
                          Het aantal decimalen wordt in dit geval niet
                          gebruikt.


Bewaren van voorkeuren als instelling bij het starten
======================================================================

De huidige voorkeuren kunnen in de huidige open database worden
bewaard. De volgende keer dat je die database opent zullen die
voorkeuren weer worden gebruikt.

Om de voorkeuren te bewaren druk je, vanaf het opening scherm, op de
Menu toets en kies je uit het "Speciaal" menu de optie "Bewaar
Voorkeuren".

Hierdoor wordt ook het huidige Calc geheugen in de database bewaard.


Gebruik van een getal uit een Calc geheugen
======================================================================

Op het hoofdscherm, in n van de twee velden voor waarden kan ook
de naam van een Calc geheugen worden ingevoerd. De naam bestaat
uit de letter M en een nummer tussen 0 en 9, bijv. "m1".


Bewaren van getal in Calc geheugen
======================================================================

Kies vanaf het openingsscherm uit het "Geheugen" menu de optie
"Mx=Van waarde" of "Mx=Naar waarde" om de huidige waarde van het
Van of Naar veld in het huidige geheugen op te slaan (x is het
nummer van dat geheugen). Als het Van (of Naar) veld een expressie
bevat wordt de waarde hiervan opgeslagen.

Het huidige Calc geheugen kan je met de optie "Wijzig geheugen"
uit het "Geheugen" menu veranderen.

LET OP: Bewaren in een Calc geheugen is gevaarlijk. Andere programma's
      (zoals Calc) kunnen dat geheugen ook veranderen. De laatst
      bewaarde waarde (door welk programma ook gezet) wordt gebruikt.


Tips
======================================================================

- In elk van de velden met lijsten (categorie, Van eenheid en
  Naar eenheid) kun je snel naar een item toe springen door
  de eerste letter ervan in te drukken. Meerdere malen dezelfde
  letter drukken levert telkens het volgende item dat met
  dezelfde letter begint.
- Als je bijv. vierkante internationale zeemijlen om wil zetten
  in vierkante meters (deze staat (nog) niet in de database, kan
  dat als volgt: kies in categorie lengte de meter en intern.
  zeemijl eenheden; converteer van zeemijl naar meter; wissel
  Van eenheid naar zeemijl en Naar eenheid naar meter, ga naar
  het Naar waarde veld (nu nog met naam "meter") en druk op
  Enter. Het Van waarde veld (nu met naam "meter") bevat het
  resultaat.
- Voor conversie van graden naar radialen (nog niet in database)
  kun je de OPL functie rad() gebruiken. Kies Van en Naar unit
  het zelfde en type in Van waarde veld "rad(123)" en druk op
  Enter.


Buitennissigheden
======================================================================

Je kunt een conversie in de database zetten (verderop wordt beschreven
hoe) waarvan de conversie factor gelijk is aan een Calc geheugen, of
waarvan in de conversie formule n of meerdere Calc geheugens bevat.

    - Dit kan handig zijn voor conversies die erg veel veranderen,
      zoals wisselkoersen. Door de huidige koers in een Calc geheugen
      te zetten kun je eenvoudig met wisselende koersen werken.
    - Het kan ook gebruikt worden voor "Wat als" omzettingen, zoals
      "Wat gebeurt er met de opbrengst als de rente varieert tussen
      een aantal waarden". De rente kan in een geheugen worden
      gezet, de invoer in het ene veld, en de opbrengst wordt berekend
      in het andere veld.
    - Het is ook mogelijk om dit te gebruiken voor formules die meer
      dan n variabele hebben.

In een formule kun je ook meer malen de ingevoerde waarde laten
opnemen. Zie verderop over veranderen van de database.

Door het gebruik van OPL functies kun je hele complexe en ook
niet voor de hand liggende conversies doen. Bijvoorbeeld, om te
converteren van een verschil in tijd naar seconden, kun je de
volgende formule gebruiken (schrik niet):

    datetosecs(1994;01;01;val(left$("xx";2));val(mid$("xx";3;2));
    val(mid$("xx";5;2)))-datetosecs(1994;01;01;val(mid$("xx";8;2));
    val(mid$("xx";10;2));val(mid$("xx";12;2)))

Hierin is aangenomen dat de "waarde" die ingevoerd is door
de gebruiker de volgende syntax heeft: uummss-uummss.
uu is uren, mm minuten en ss seconden. Bijvoorbeeld
120101-120002 zou als aantal seconden 59 moeten opleveren.


======================================================================
Veranderen van de database
----------------------------------------------------------------------

Zoals eerder gezegd zijn alle conversie specificaties opgeslagen in
een database. Dit is een normale database die met het standaard Data
programma op de Psion 3a kan worden gewijzigd. Alle velden in de
database zijn tekst velden, hoewel sommige waarden of formules
moeten bevatten.

De conversies zijn gesplitst in categorien. Elke categorie heeft
een centrale eenheid. Binnen een categorie moeten alle conversies
van of naar die centrale eenheid worden gegeven. JAICNV kan daardoor
binnen een categorie elke eenheid naar elke andere eenheid omzetten,
door via centrale eenheid te rekenen. Je hoeft daarvoor niet de
conversie tussen elk van die eenheden te geven, maar slechts voor
elke eenheid n conversie naar de centrale eenheid.


Database specificatie
======================================================================

De database bevat zes velden:

- Van eenheid
- Naar eenheid
                    In deze twee velden moeten de namen van de
                    eenheden worden ingevuld die in de selectie
                    lijsten voor eenheden op het hoofdscherm komen.
                    En van deze eenheden moet altijd centrale
                    eenheid zijn.
- Factor
                    De factor is een getal (of de naam van een Calc
                    geheugen) die aangeeft met welke factor de
                    "Van" waarde moet worden vermenigvuldigd om de
                    "Naar" waarde te krijgen.
                    Omdat deze conversie een factor is, kan JAICNV
                    tevens de conversie van de "Naar" naar de "Van"
                    waarde uitvoeren.
                    Als je een formule wilt gebruiken moet het factor
                    veld leeg zijn.
- Formule
                    Als de conversie niet met een factor kan worden
                    uitgevoerd (bijv. van graden Celsius naar
                    Fahrenheit) moet in dit veld een formule worden
                    gegeven om de "Van" in de "Naar" waarde te kunnen
                    omrekenen. Als je ook van de "Naar" naar de "Van"
                    waarde wilt kunnen omrekenen, moet je in dit geval
                    een apart kaart in de database maken, met de juiste
                    formule.
                    In de formule worden de letters "xx" gebruikt, om
                    de plaats aan te geven waar de "Van" waarde in de
                    formule moet worden ingevuld (n "x" is niet
                    voldoende, omdat in een formule ook de OPL functie
                    "exp()" mag worden gebruikt). Een formule kan
                    een constante zijn (dus zonder xx), maar ook
                    mag in de formule meer keer xx voorkomen (ze
                    worden allen door de ingevulde waarde vervangen).
                    Een formule mag OPL functies bevatten. Let op
                    dat het teken voor scheiding van functie
                    argumenten wordt bepaald door de instelling
                    van de default "DecimalSign" (zie verderop).
- Van beschrijving
- Naar beschrijving
                    Dit zijn langere beschrijvingen van de eenheden.
                    Vaak is het de volledige naam van een eenheid,
                    maar elke tekst is toegestaan.
                    Het wordt getoond vr de waarde velden op het
                    hoofdscherm.
                    De beschrijving voor de centrale eenheid hoeft
                    niet te worden ingevuld. Deze wordt altijd van
                    categorie kaart gehaald.

Categorien invoeren
======================================================================

Een categorie beschrijving wordt op een aparte kaart ingevuld, en wel
als volgt:

- Het "Van eenheid" veld moet de waarde "category:" hebben
- Het "Naar eenheid" veld moet de naam van de centrale eenheid hebben.
- De Factor en Formule velden worden niet gebruikt.
- Het "Van beschrijving" veld moet de naam van de categorie bevatten.
  Deze wordt in de lijst met categorien op het hoofdscherm gebruikt.
- Het "Naar beschrijving" veld moet de beschrijving voor de centrale
  eenheid bevatten. Deze wordt altijd gebruikt als je van of naar de
  centrale eenheid converteert.

Standaard instellingen (defaults)
======================================================================

De database bevat ook een aantal standaard instellingen die je kan
veranderen. Elke standaard instelling staat op een aparte kaart, en
wel als volgt:

- Het "Van eenheid" veld moet de tekst "default:" bevatten.
- Het "Naar eenheid" veld moet n van de speciale woorden bevatten
  (zie verderop)
- De factor and formule velden worden niet gebruikt.
- Het "Van beschrijving" veld moet de waarde voor de default bevatten.
- Het "Naar beschrijving" veld wordt niet gebruikt. Eventueel kunnen
  er opmerkingen in staan over welke waarden ingevuld kunnen worden.

De volgende speciale woorden kunnen worden gebruikt:
- HelpFile               Pad en filenaam van de te gebruiken help file.
* MemoryNr               Nummer van het actieve Calc geheugen
* ValWidth               Maximale breedte van berekende waarden
* ValPrecision           Aantal decimalen dat van berekende waarden
                         wordt getoond.
* Notation               1 (wetenschappelijk), 2 (vast), 3 (optimaal)
- DecimalSign            Decimaal scheidingsteken: , of .
                         Hierdoor wordt tevens het scheidingsteken
                         voor OPL functieargumenten bepaald op
                         ";" resp. ",".

Een aantal van deze standaard waarden kan ook binnen Jaicnv worden
veranderd en weer in de database worden bewaard. Deze zijn aangegeven
met een *.

Beperkingen
======================================================================

De implementatie van JAICNV beperkt o.a. het aantal categorien
en het aantal eenheden binnen en categorie:

- De totale lengte van alle categorie namen (in de "Van beschrijving"
  velden op de categorie kaarten) mag niet langer zijn dan 255 minus
  het aantal categorien.
- De totale lengte van alle namen van eenheden, zoals die in de
  Van of Naar eenheid lijsten op het hoofdscherm voorkomen, mag
  niet langer zijn dan 255 minus het aantal eenheden in de lijst.
  (let op dat eenheden met een factor zowel in de Van als de Naar
  lijst komen).

JAICNV waarschuwt als deze grenzen worden overschreden.
Om zoveel mogelijk eenheden in een lijst te krijgen is het verstandig
om en namen van de eenheden zo kort mogelijk te houden. De volledige
naam kan dan in de beschrijving van de eenheid.

Verder gelden de volgende beperkingen:

- Namen van eenheden mogen niet langer dan 100 karakters zijn
- Beschrijvingen mogen niet langer dan 100 karakters zijn
     Dit zijn eigenlijk geen beperkingen, omdat zulke lange namen
     of beschrijvingen toch niet op het scherm passen.
- Formules mogen niet langer zijn dat 255 tekens, minus de lengte
  van de in te vullen waarde.
- Namen van categorien en eenheden mogen geen komma's bevatten.


======================================================================
Vertalingen
----------------------------------------------------------------------

Internationalisatie
======================================================================

Verschillende landen hebben verschillende lokale eenheden, en
mogelijk verschillende namen voor de zelfde eenheid.

     Een "zeemijl" heet in het engels bijvoorbeeld een
     "nautical mile"

Omdat JAICNV gebruik maakt van een database met units, en je toestaat
andere databases te gebruiken, is het mogelijk om aparte database
in verschillende talen te maken.

In de distributie staat naast de Nederlandse een Engelse
versie van de database, genaamd "jaicnven.dbf" (dit ook om de
verspeidingsgraad van het programma te vergroten, want het
Nederlandse taalgebied is niet zo groot).

Voor een volledige vertaling moet ook de veld namen, menu opties
en help teksten worden vertaald, en natuurlijk deze handleiding.
De code is zodanig dat alle teksten in het programma uit de help
database worden gehaald. Omdat ook deze database gewoon met het
Data programma kan worden bewerkt, kan die ook vrij eenvoudig
worden omgezet (verder op meer hierover).

Een aandachtspunt bij het ondersteunen van meerdere talen is het
teken dat wordt gebruikt als decimaal scheiding. In het Nederlands
een komma "," gebruikelijk, in veel andere landen is een punt ".".
Jaicnv gebruikt het teken zoals die in jou Psion is gezet.
In de database kun je n van de twee kiezen, maar die moet je
dan wel consistent in de hele database gebruiken. Standaard zal
Jaicnv aannemen dat de getallen in de database een punt als decimaal
scheiding gebruiken. Met de default "DecimalSign" in de database
kun je de deze op een komma zetten (zie sectie over standaard
instellingen).
Het is aan te bevelen deze default ook expliciet in de database
te zetten als je een punt gebruikt (in plaats van te vertrouwen
op de hard gecodeerde standaard instelling).
Door de instelling van DecimalSign ligt ook vast hoe functie
argumenten in formules moeten worden gescheiden: met ";" of ",".


Vertalen van de help file
======================================================================

De help file is een normale database, die met de Data applicatie op
de Psion 3a kan worden bewerkt. Het bevat een aantal dingen:

- De help teksten (en het voorbehoud scherm).
  Elk help item staat op een aparte kaart. Er kunnen maximaal 8
  help items (kaarten) zijn. Elke kaart mag maximaal 8 regels
  tekst bevatten.
- Teksten van menus.
  Elk menu staat op een aparte kaart en heeft een vaste naam.
  De menu items staan op dezelfde kaart, n per regel in een
  vaste volgorde. Kijk in een bestaande database voor je juiste
  volgorde.
- Teksten voor schermen.
  Er is voor elk scherm n kaart. Net als voor menus heeft die
  een vast naam, en hebben de items op de regels een vaste volgorde.
  Sommige velden op een scherm kunnen ook een lijst van toegestane
  waarden bevatten (ook in een vaste volgorde). Een voorbeeld is
  de lijst van notaties op het voorkeuren scherm.
- Foutmeldingen
  Elke foutmelding staat op een aparte kaart. Het heeft weer een
  vaste naam ter identificatie (die dus niet vertalen). De melding
  kan n of twee regels zijn.
  In sommige foutmeldingen moet tijdens runtime een tekst worden
  ingevuld. In de database moet in de foutmelding worden aangegeven
  waar die tekst moet worden ingevuld. Als er n tekst moet worden
  ingevuld moet de melding "%s1" bevatten op de plaats waar die
  tekst moet komen. Zijn er twee teksten, dan moeten "%s1" en "%s2"
  de plaatsen aangeven. Je moet zorgen dat een melding het juiste
  aantal plaatsaanduiders bevat. Het maakt niet uit in welke van de
  twee regels die staan, en in welke volgorde (als er twee zijn).
- Strings
  En string per kaart, met vast naam. De string waarde moet in het
  "Msg" veld.

Een record in de help database bevat de volgende velden:
- Type:   moet n van de strings "help:", "menu:", "panel: fatal"
          "error:" of "string:" bevatten.
          "help: disclaimer" wordt gebruikt voor het voorbehoud.
- Naam:   Naam/tekst van item (voor help) of n van de vaste namen
          (voor andere types)
- Msg:    Eerste regel (voor help en error), menu naam, scherm titel,
          waarde van string.
- Regel1: Tweede regel (voor help of error), menu item, panel item.
- Regel2-Regel8: Volgende regels (voor help), menu item, panel item.


Tips
======================================================================

Voor een volledige vertaling vindt ik het makkelijker om de
database in tekst formaat te bewaren, met een nieuwe regel als
veldscheiding, deze op de PC te wijzigen, en dan met een lege
database samen te voegen.

Kijk wel uit welke editor je op de PC gebruikt. Lege velden
worden aangegeven door een regel met precies n spatie. Records
worden door een geheel lege regel gescheiden. Als je editor de
spaties aan het eind van een regel weggooit krijg je GROTE problemen.

Je kunt ook internationale en wetenschappelijk tekens in de database
gebruiken. Het lijkt erop dat die het zelfde zijn op de PC en de
Psion.


======================================================================
OPL code
----------------------------------------------------------------------

Vertalen
======================================================================

Als je de OPL code wilt vertalen in een OPA moet je de file
     jaicnv.pic
in directory
     \pic
zetten (of de code aanpassen).

Hergebruik
======================================================================

Misschien vindt je concepten van o.a. internationalisatie en help
interessant. Omdat de code is meegeleverd kan je de code die die
concepten implementeert hergebruiken.

MAAR, HET PROGRAMMA EN DE CODE VALLEN ONDER DE CONDITIES VAN DE
GNU GENERAL PUBLIC LICENSE. LEES DIE EERST VOOR JE CODE GAAT
HERGEBRUIKEN. HET STAAT IN DE FILE COPYING.GPL

En van de regels houdt in dat de software die je met deze software
maakt ook weer vrij beschikbaar moet zijn onder de zelfde GNU GPL
condities.
Verder vraag ik je om bij hergebruikte code te zetten dat ik die
heb geschreven.

Als je code wilt hergebruiken in een programma dat onder andere
voorwaarden wordt verspreidt, schrijf mij dan.


======================================================================
Ten slotte: Hou me op de hoogte
----------------------------------------------------------------------

Omdat dit vrije software is, en zowel de code als de database
veranderd kunnen worden, kun je zelf wijzigingen aanbrengen
(maar let wel op de regels die in de GNU licentie overeenkomst
staan, die met de distributie is meegeleverd).

Als je een database maakt met bruikbare conversies, als je
een database vertaalt, of als je handige veranderingen of
uitbreidingen aan het programma maakt, laat het me dan weten.

Ook als je opmerkingen hebt, bugs vindt, of ideen hebt voor
uitbreidingen kun je me die laten weten.

Mijn email en post adressen staan bovenaan dit document.

