1 files changed, 703 insertions, 0 deletions
diff --git a/tde-i18n-da/docs/tdewebdev/kommander/specials.docbook b/tde-i18n-da/docs/tdewebdev/kommander/specials.docbook
new file mode 100644
index 00000000000..7aa0e63cb01
--- /dev/null
+++ b/tde-i18n-da/docs/tdewebdev/kommander/specials.docbook
@@ -0,0 +1,703 @@
+<?xml version="1.0"  encoding="UTF-8" ?>
+
+<sect1 id="specials">
+<sect1info>
+<title
+>Specielle og indbyggede globale variable</title>
+<authorgroup>
+<author
+><firstname
+></firstname
+> <surname
+></surname
+> <affiliation
+><address
+> <email
+></email>
+</address
+></affiliation>
+</author>
+
+&rune.laursen.role; 
+
+</authorgroup>
+</sect1info>
+
+<title
+>Specielle og indbyggede globale variable</title>
+
+<para
+>Specielle er funktioner der behandles af &kommander;. Du skal være opmærksom på at indtil &kommander; har en fuldstændig fortolker, vil alle specielle eksekveres først og derefter eksekveres scriptet. I de fleste tilfælde er dette ikke et problem, men somme tider opstår der problemer. </para>
+
+<variablelist>
+<varlistentry>
+<term
+><function
+>@dcop(<parameter
+>appId</parameter
+>, <parameter
+>objekt</parameter
+>, <parameter
+>funktion</parameter
+>, <parameter
+>argumenter</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Lav et &DCOP;-kald. @DCOP(<quote
+>kmail</quote
+>, <quote
+>KMailIface</quote
+>, <quote
+>checkMail()</quote
+>, <quote
+></quote
+>) </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@dcopid</function
+></term>
+<listitem>
+<para
+>Processens &DCOP;-ID (kmdr-executor-@pid) </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@dialog(<parameter
+>dialog</parameter
+>[,<parameter
+>parametre</parameter
+>])</function
+></term>
+<listitem>
+<para
+>Starter den givne kommander-dialog. Dialogen søges i dialogkataloget og i det aktuelle katalog, i den rækkefølge. Dette kommer før kaldet til executoren og sætter standardkataloget til den Kommander-programmet findes i. Parametre kan overføres i sædvanlig UNIX-stil eller overføres som <quote
+>variabel=værdi</quote
+>. Du kan derefter finde overførte parametre i den globale samling. @global(variable) ville returnere <quote
+>værdi</quote
+>. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@env(<parameter
+>miljøVariabel</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Udvides til den givne miljøvariabel. @env(PWD) udvides til $PWD. Husk at <quote
+>$</quote
+> er en del af skallen og ikke må bruges. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@exec(<parameter
+>kommando</parameter
+>)</function
+></term>
+<listitem>
+<para
+>returnerer uddata ved eksekveringen af den givne kommando @exec(ls -l). </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@execBegin ... @execEnd</function
+></term>
+<listitem>
+<para
+>ligesom <function
+>@exec</function
+>, men understøtter shebang og multilinje scripter. Dette servicerer forskellige scriptsprog, enten ved at erklære dem eller ved at bruge en shebang. </para>
+<itemizedlist>
+<listitem
+><para
+><function
+>@execBegin(php)</function
+></para
+></listitem>
+<listitem
+><para
+><function
+>@execBegin</function
+>#!/usr/bin/php</para
+></listitem>
+</itemizedlist>
+<para
+>Den første bruger navnet på <acronym
+>PHP</acronym
+>-kørbare. &kommander; søger i PATH efter <application
+>php</application
+> og ser efter et sted uden din sti, om den er registreret i &kommander; hvis ikke den findes. Hvis ikke før den brugeren opmærksom på at den ikke blev fundet. Det andet eksempel bruger den klassiske <quote
+>shebang</quote
+> som kan have nogle fordele og problemer. Hvis du har en betaudgave af <acronym
+>PHP5</acronym
+> i f.eks. <filename
+>/usr/local/bin</filename
+> som ikke ville blive fundet fordi der søges i <filename
+>/usr/bin</filename
+> er dette brugbart. Hvis du derimod distribuerer dialogen til en som kun har <acronym
+>PHP</acronym
+> i <filename
+>/usr/local/bin</filename
+> ville den ikke blive fundet når der bruges en shebang. Så at bruge shebang skal tages med forbehold og det anbefales at bruge den eksekverbare hvis du deler filer.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@global(<parameter
+>variabel</parameter
+>)</function
+></term>
+<listitem>
+<para
+>udvides til værdien af den givne globale variabel. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@null</function
+></term>
+<listitem>
+<para
+>Returnerer null. Nu da Kommander undersøger for tom widgetText på kørselstidspunktet, forebygger dette, fejlagtige fejl hvis en kontrol har en tilstand der ikke er sat.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@parentPid</function
+></term>
+<listitem>
+<para
+>Forældreprocessens &PID;. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@pid</function
+></term>
+<listitem>
+<para
+>Processens &PID;. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@readSetting(<parameter
+>nøgle</parameter
+>, <parameter
+>standardVærdi</parameter
+>)</function
+></term>
+<listitem>
+<para
+>læser en værdi fra <filename
+>kommanderrc</filename
+> </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@selectedWidgetText</function
+></term>
+<listitem>
+<para
+>det markerede indhold i en kontrol som kan vise mere end en værdi, som listekontroller </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@setGlobal(<parameter
+>variabel</parameter
+>, <parameter
+>værdi</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Sætter den globale variabel til den givne værdi. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@widgetText</function
+></term>
+<listitem>
+<para
+>en kontrols indhold </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@writeSetting(<parameter
+>nøgle</parameter
+>, <parameter
+>værdi</parameter
+>)</function
+></term>
+<listitem>
+<para
+>skriv værdi til <filename
+>kommanderrc</filename
+> </para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<sect2 id="arrays">
+<title
+>Array-funktionsgruppe</title>
+
+<variablelist>
+<varlistentry>
+<term
+><function
+>@Array.values(<parameter
+>array</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Returnerer EOL-adskilt liste af alle værdier i arrayet. Kan bruges til at gennemgå et array.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.keys(<parameter
+>array</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Returnerer en EOL-adskilt liste af alle nøgler i arrayet.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.setValue(<parameter
+>array</parameter
+>, <parameter
+>nøgle</parameter
+>, <parameter
+>værdi</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Sætter en nøgle og en værdi til et element i et array. Eksisterer der ikke et array i forvejen, oprettes der et.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.clear(<parameter
+>array</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Fjerner alle elementer i et array.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.count(<parameter
+>array</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Returnerer antallet af elementer i arrayet.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.value(<parameter
+>array</parameter
+>,<parameter
+>nøgle</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Returnerer værdie associeret med den givne nøgle.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.remove(<parameter
+>array</parameter
+>,<parameter
+>nøgle</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Fjern element med given nøgle fra arrayet.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.fromString(<parameter
+>array</parameter
+>,<parameter
+>streng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Tilføjer alle elementer i strengen til arrayet. Strengen skal have formatet:<emphasis
+>nøgle\tværdi\n</emphasis
+>."</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.toString(<parameter
+>array</parameter
+>,<parameter
+>streng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>"Returnerer alle elementer i array i <emphasis
+>nøgle\tværdi\n</emphasis
+> format."</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="files">
+<title
+>Filfunktionsgruppe</title>
+<variablelist>
+
+<varlistentry>
+<term
+><function
+>@File.read(<parameter
+>fil</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Returnerer indhold af den givne fil.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@File.write(<parameter
+>fil</parameter
+><parameter
+>streng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Skriv given streng til en fil.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@File.append(<parameter
+>fil</parameter
+><parameter
+>streng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Tilføj given streng til slutningen af en fil.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="strings">
+<title
+>Strengfunktionsgruppe</title>
+<variablelist>
+
+<varlistentry>
+<term
+><function
+>@String.length(<parameter
+>streng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Returnerer antal tegn i strengen.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.contains(<parameter
+>streng</parameter
+>,<parameter
+>understreng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Undersøger om strengen indeholder den givne understreng.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.find(<parameter
+>streng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Returnerer en understrengs position i strengen eller -1 hvis den ikke findes."</para>
+<note
+><para
+>Dette får en valgfri startposition angivet med et heltal til søgning efter næste, i alfa 6.</para
+></note>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.left(<parameter
+>streng</parameter
+>, <parameter
+>heltalt</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Returnerer første n tegn i strengen.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.right(<parameter
+>streng</parameter
+>, <parameter
+>heltal</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Returnerer sidste n tegn i strengen.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.mid(<parameter
+>streng</parameter
+>, <parameter
+>heltal startposition</parameter
+>, <parameter
+>heltal slutposition</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Returnerer strengens understreng, begynder fra given position.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.remove(<parameter
+>streng</parameter
+>, <parameter
+>understreng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Fjerner alle forekomster af den givne understreng.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.replace(<parameter
+>streng</parameter
+>, <parameter
+>understreng find</parameter
+>, <parameter
+>understreng erstat</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Erstatter alle forekomster af en given understreng med den givne erstatningsstreng.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.upper(<parameter
+>streng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Konverterer strengen til store bogstaver.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.lower(<parameter
+>streng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Konverterer strengen til små bogstaver.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.compare(<parameter
+>streng</parameter
+>, <parameter
+>streng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Sammenligner to strenge. Returnerer 0, hvis de er ens, -1 hvis den første er mindst, 1 hvis den første er størst.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.isEmpty(<parameter
+>streng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Undersøger om strengen er tom.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.isNumber(<parameter
+>streng</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Undersøger om strengen er et gyldigt tal.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="builtins">
+<title
+>Indbyggede globale</title>
+<para
+>Indbyggede globale tilgås ligesom almindelige globale variable med <function
+>@global</function
+>.</para>
+<variablelist>
+<varlistentry>
+<term
+><function
+>@global(_KDDIR)</function
+></term>
+<listitem>
+<para
+>Katalogen den aktuelle dialog er i.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term
+><function
+>@global(_NAME)</function
+></term>
+<listitem
+><para
+>Navnet på dialogen</para
+></listitem>
+</varlistentry>
+</variablelist>
+</sect2>
+
+</sect1>