home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 1 / FFMCD01.bin / bbs / libdisks / d700t799 / disk774.lha / ExtraCmds / ExtraCommands.autodocs < prev    next >
Encoding:
Text File  |  1992-12-05  |  28.2 KB  |  897 lines

  1. TABLE OF CONTENTS
  2.  
  3. dansk:--Introduktion--
  4. dansk:COMMON
  5. dansk:CONCAT
  6. dansk:COUNT
  7. dansk:DIRTREE
  8. dansk:HEAD
  9. dansk:LOWER
  10. dansk:SPLIT
  11. dansk:TEE
  12. dansk:TIMECOM
  13. dansk:UNIQUE
  14. English:--Introduction--
  15. English:COMMON
  16. English:CONCAT
  17. English:COUNT
  18. English:DIRTREE
  19. English:HEAD
  20. English:LOWER
  21. English:SPLIT
  22. English:TEE
  23. English:TIMECOM
  24. English:UNIQUE
  25. dansk:--Introduktion--                         dansk:--Introduktion--
  26.  
  27.    FORMÅL
  28.        At give en kortfattet introduktion til de ekstra AmigaDOS
  29.        kommandoer.
  30.  
  31.    SPECIFIKATION
  32.        Kommandoerne i denne distribution blev skrevet som et
  33.        supplement til samlingen distribueret af Coomodore-Amiga,
  34.        Inc. som en del Systemprogrammelfrigivelse 2.04 (V37) og
  35.        kan ikke køre under ældre frigivelser.
  36.  
  37.        Selvom de generelt er modelleret efter tilsvarende UNIX-
  38.        kommandoer har de en betydelig anderledes grænseflade
  39.        fordi de alle bruger standard AmigaDOSskabeloner.
  40.  
  41.        Alle kommandoerne er `pure' og kan gøres residente.
  42.        Hvis p-flagene ikke er sat når pakken modtages kan man
  43.        sætte dem med kommandoen PROTECT.
  44.  
  45.    SE OGSÅ
  46.        `The AmigaDOS Manual', 3. udgave, Bantam Books, 1991
  47.        og manualen `Using The System Software' leveret med
  48.        Frigivelse 2.04.
  49.  
  50.    OPHAVSRET
  51.        Alle programmer og andre filer inkluderet i denne frigivelse
  52.        er Copyright (c) 1989, 1990, 1991, 1992 Torsten Poulin.
  53.  
  54.              Ophavsretsmeddelelserne i kommandoerne kan vises
  55.              ved at indtaste følgende AmigaDOSkommando:
  56.                  1> VERSION <command> FULL
  57.  
  58.        Rod bare med kildeteksterne.  Hvis De laver nogen
  59.        forbedringer, vil jeg blive glad for at få en kopi af dem
  60.        så jeg eventuelt kan medtage dem i næste frigivelse.
  61.  
  62.        Dette er gratis programmer ikke "shareware".  Hav ingen
  63.        skyldfølelse ved at bruge dem uden at betale.  Den
  64.        eneste betaling jeg virkelig vil sætte pris på er hvis
  65.        De vil lade mig høre om eventuelle fejl i dem.  Selvfølgelig
  66.        kan jeg ikke acceptere at andre tjener egentlige penge på at
  67.        distribuere denne programpakke.  Den må kun distribueres
  68.        ikke-kommercielt, uden betaling bortset fra det sædvanlige
  69.        __MINDRE_ beløb til at betale for distributionsmediet.
  70.  
  71.    FORFATTERENS ADRESSE
  72.        Send venligst forslag, fejlrapporter, forbedringer osv.
  73.        til følgende adresse:
  74.            Torsten Poulin
  75.            Banebrinken 99, 2, lejlighed 77
  76.            2400  København NV
  77.  
  78.    VAREMÆRKER
  79.        AmigaDOS er et registreret varemærke tilhørende
  80.        Commodore-Amiga, Inc.
  81.        UNIX er et registreret varemærke tilhørende AT&T.
  82.  
  83.    TAKSIGELSE
  84.        Formuleringen af de følgende manualsider skylder en hel del
  85.        til diverse UNIXmanualer.  Jeg håber at folkene bag UNIX
  86.        ikke har noget imod det.
  87.  
  88. dansk:COMMON                                             dansk:COMMON
  89.  
  90.    FORMAT
  91.        COMMON [FILE1] <fil1> [[FILE2] <fil2>] [-1] [-2] [-3]
  92.  
  93.    SKABELON
  94.        FILE1/A,FILE2,-1/S,-2/S,-3/S
  95.  
  96.    FORMÅL
  97.        At vælge eller fravælge linjer fælles for to sorterede filer.
  98.  
  99.    SPECIFIKATION
  100.        Kommandoen Common læser <fil1> og <fil2>, som skal være
  101.        ordnet i rangfølgen brugt af SORT, og udskriver tre spalter:
  102.        linjer der kun findes i <fil1>, linjer der kun findes i
  103.        <fil2> og linjer der findes i begge filer.
  104.  
  105.        Kontakterne -1, -2 og -3 undertrykker udskrivningen af de
  106.        tilsvarende spalter.  Således udskriver Common -1 -2 kun de
  107.        linjer som er fælles for de to filer; Common -2 -3 udskriver
  108.        kun linjer som findes i den første fil, men ikke i den anden.
  109.        Common -1 -2 -3 udskriver ingenting.
  110.  
  111.    SE OGSÅ
  112.        SORT, UNIQUE
  113.  
  114.    TILSVARENDE I UNIX
  115.        comm(BU_CMD)
  116.  
  117. dansk:CONCAT                                             dansk:CONCAT
  118.  
  119.    FORMAT
  120.        CONCAT [[FROM] <filer|mønstre>] [TO <navn>]
  121.               [SORT] [QUIET] [VISIBLE [TABS] [EOL]] [UNBUF]
  122.  
  123.    SKABELON
  124.        FROM/M,TO/K,SORT/S,QUIET/S,VISIBLE/S,TABS/S,EOL/S,UNBUF/S
  125.  
  126.    FORMÅL
  127.        At sammenkæde og udskrive filer.
  128.  
  129.    SPECIFIKATION
  130.        Concat læser hver af de med FROM angivne filer og skriver
  131.        dem til destinationen angivet af TO.  Hvis der ikke er
  132.        angivet nogen FROM-filer, læser Concat fra sit standard-
  133.        input.  Ligeledes skriver den til sit standardoutput hvis
  134.        der ikke er angivet en destination med TO.
  135.  
  136.        Følgende kontakter kan bruges med Concat:
  137.  
  138.        SORT    FROM-filerne læses i alfabetisk orden.  Nyttigt
  139.                ved sammenkædning af filer splittet med SPLIT.
  140.  
  141.        QUIET   Concat tier stille om ikke-eksisterende filer.
  142.  
  143.        VISIBLE Usynlige tegn (med undtagelse af tabulerings- og
  144.                ny-linjetegn) bliver udskrevet synligt.
  145.                Styretegn udskrives som ^X (kontrol-x). 
  146.                Slettetegnet (heksadecimalt 0x7d) udskrives som
  147.                ^?. Ikke-ASCII-tegn (med mest betydende bit sat)
  148.                udskrives som M-x, hvor x er tegnet givet ved de
  149.                syv mindst betydende bit.
  150.  
  151.        UNBUF   Uddata bliver ikke bufferet. (Standard er bufferet
  152.                uddata.)
  153.  
  154.        Når kontakten VISIBLE er angivet kan følgende kontakter
  155.        bruges:
  156.  
  157.        TABS    Tabuleringstegn udskrives som ^I'er.
  158.  
  159.        EOL     Et $-tegn udskrives i slutningen af hver linje (før
  160.                ny-linjetegnet).
  161.  
  162.        Kontakterne TABS og EOL bliver ignoreret hvis kontakten
  163.        VISIBLE ikke er angivet.
  164.  
  165.    SE OGSÅ
  166.        COPY, JOIN, MORE, SPLIT, TYPE
  167.  
  168. dansk:COUNT                                               dansk:COUNT
  169.  
  170.    FORMAT
  171.        COUNT [[FROM] <navne|mønstre>] [LINES] [WORDS] [CHARS]
  172.  
  173.    SKABELON
  174.        FROM/M,LINES/S,WORDS/S,CHARS/S
  175.  
  176.    FORMÅL
  177.        At tælle linjer, ord og tegn.
  178.  
  179.    SPECIFIKATION
  180.        Count tæller linjer, ord og tegn i de nævnte filer eller fra
  181.        sit standardinput hvis ingen navne er angivet.  Den laver
  182.        også en sluttotal for alle filerne.  Et ord er en maksimal
  183.        tegnfølge afgrænset af blank-, tabulerings- eller
  184.        ny-linjetegn.
  185.  
  186.        Kontakterne LINES, WORDS og CHARS kan bruges til at angive
  187.        at en delmængde af linjer, ord og tegn skal rapporteres.
  188.        Hvis der ikke angives nogen kontakter antager Count at der
  189.        menes dem alle sammen.
  190.  
  191.        Når filnavne angives på kommandolinjen udskrives de sammen
  192.        med optællingerne.
  193.  
  194. dansk:DIRTREE                                           dansk:DIRTREE
  195.  
  196.    FORMAT
  197.        DirTree [DIR] {<katalog>} [NOHEAD]
  198.  
  199.    SKABELON
  200.        DIR/A/M,NOHEAD/S
  201.  
  202.    FORMÅL
  203.        At udskrive underkatalogtræer.
  204.  
  205.    SPECIFIKATION
  206.        DirTree viser underkatalogtræer for de kataloger eller diske
  207.        som er givet ved argumentet DIR.  Kontakten NOHEAD
  208.        undertrykker udskrivningen af overskriftinformationen.
  209.  
  210.    EKSEMPEL
  211.            1> DIRTREE ram:
  212.            Directory tree for "ram:" on Saturday 22-Feb-92
  213.  
  214.            Ram Disk
  215.            +---Clipboards
  216.            +---env
  217.            |   `---sys
  218.            |  
  219.            `---T
  220.  
  221.    SE OGSÅ
  222.        DIR, LIST
  223.  
  224. dansk:HEAD                                                 dansk:HEAD
  225.  
  226.    FORMAT
  227.        HEAD [[FROM] <filer|mønstre>] [TO <fil>] [NUMBER <n>]
  228.  
  229.    SKABELON
  230.        FROM/M,TO/K,NUM=NUMBER/N/K
  231.  
  232.    FORMÅL
  233.        At vise de første få linjer af de angivne filer.
  234.  
  235.    SPECIFIKATION
  236.        Head kopierer de første NUMBER linjer fra hver FROM-fil
  237.        til sit standardoutput eller, hvis en fil er angivet med
  238.        TO, til den.  Hvis ingen filer er angivet med FROM,
  239.        kopierer Head linjer fra sit standardinput.  Angives der
  240.        ikke noget antal linjer med NUMBER, vises 10.
  241.  
  242.        Når mere end én fil angives, markeres begyndelsen af hver
  243.        fil således:
  244.  
  245.                ==>filnavn<==
  246.  
  247.    EKSEMPEL
  248.        En måde at vise en samling korte filer, med deres navne,
  249.        er:
  250.  
  251.            1> HEAD filnavn1 filnavn2 NUMBER 9999
  252.  
  253.    SE OGSÅ
  254.        CONCAT, TAIL, TYPE
  255.  
  256.    TILSVARENDE I UNIX
  257.        head(BU_CMD)
  258.  
  259. dansk:LOWER                                               dansk:LOWER
  260.  
  261.    FORMAT
  262.        LOWER [BY <værdi>] [STACK <størrelse>]
  263.              [COMMAND] <kommandlinje>
  264.  
  265.    SKABELON
  266.        BY/K/N,STACK/K/N,COMMAND/F/A
  267.  
  268.    FORMÅL
  269.        At udføre en kommando med en rar, muligvis lavere, prioritet.
  270.  
  271.    SPECIFIKATION
  272.        Da Amigaen er et samkørselssystem bruger den prioritetstal
  273.        til at afgøre i hvilken orden de nuværende opgaver skal
  274.        betjenes.  Normalt har de fleste opgaver prioriteten 0, og
  275.        centralenhedens tid deles lige mellem dem.
  276.  
  277.        LOWER udfører den angivne kommandolinje med prioriteten
  278.        sænket med <værdi>.  Hvis der ikke er angivet nogen værdi
  279.        med BY, bruges 1 som standardværdi.  Hvis en negativ værdi
  280.        angives vil prioriteten blive hævet istedet.  Den
  281.        resulterende prioritet skal være mellem -128 og +10.  Dette
  282.        bliver håndhævet tavst.
  283.  
  284.        Argumentet STACK sætter stakstørrelsen for den kommando der
  285.        skal udføres.  Standard er at beholde den nuværende
  286.        størrelse.
  287.  
  288.        Argumentet <kommandolinje> kan være enhver tilladt shell-
  289.        kommandolinje.  Dvs. at det er muligt at benytte omdiri-
  290.        gering, aliaser, residente kommandoer osv.
  291.  
  292.        LOWER efterlader resultaterne af den udførte kommando
  293.        i tilstandsflagene RC og Result2.  Ctrl-C, D, E og F
  294.        sendes til kommandoen der er ved at blive udført.
  295.  
  296.        Kort sagt, brugen af LOWER er transparent.
  297.  
  298.    EKSEMPLER
  299.        Skriv
  300.  
  301.           1> LOWER COPY Tekst TO PRT:
  302.  
  303.        for at udskrive filen Tekst på skriveren.
  304.        Og for at søge, i baggrunden, efter forekomster af tegn-
  305.        følgen "foo", i kataloget S:, kan man gøre følgende:
  306.  
  307.            1> RUN LOWER BY 2 SEARCH S: "foo" TO MinUddatafil
  308.  
  309.    SE OGSÅ
  310.        CHANGETASKPRI, STACK, STATUS
  311.  
  312. dansk:SPLIT                                               dansk:SPLIT
  313.  
  314.    FORMAT
  315.        SPLIT [[FROM] <fil>] [TO <navn>] [NUMBER <n> [PARTS]]
  316.              [BYTES] [PROMPT]
  317.  
  318.    SKABELON
  319.        FROM,TO/K,NUM=NUMBER/K/N,PARTS/S,BYTES/S,PROMPT/S
  320.  
  321.    FORMÅL
  322.        At splitte en fil i mindre stykker.
  323.  
  324.    SPECIFIKATION
  325.        Split læser <fil> og udskriver den i <n>-linje stykker
  326.        (standard er 1000 linjer) som en gruppe filer.  Navnet
  327.        på den første uddatafil er <navn> efterfulgt af aa og
  328.        så fremdeles, leksikografisk, indtil zz (højst 676 filer).
  329.        <navn> forkortes til 28 tegn hvis det er længere.  Hvis
  330.        der ikke er angivet noget uddatanavn, bruges x.
  331.  
  332.        Hvis kontakten BYTES bruges vil inddatafilen blive delt
  333.        i stykker på <n> tegn i stedet.  Dette er særlig nyttigt
  334.        hvis inddata er en binær fil.
  335.  
  336.        Kontakten PARTS, der kun kan bruges sammen med argumentet
  337.        NUMBER, deler inddatafilen i det angivne antal dele.
  338.  
  339.        Kontakten PARTS indebærer automatisk kontakten BYTES.
  340.  
  341.        Hvis kontakten PROMPT angives vil brugeren blive spurgt
  342.        før hver uddatafil skrives for at muliggøre disketteskift.
  343.  
  344.        Hvis ingen inddatafil er angivet læses fra standardinputtet,
  345.        hvilket gør det muligt at bruge Split som afslutningen på
  346.        en pipe.
  347.  
  348.    EKSEMPEL
  349.        Hvis filen `minfil' splittes op med en kommando som
  350.            1> SPLIT minfil TO splitfil.
  351.        kan den samles igen med følgende kommando:
  352.            1> CONCAT splitfil.?? TO nyfil SORT
  353.  
  354.    ADVARSEL
  355.        Brug ikke kontakten PARTS hvis der læses fra en pipe, da
  356.        den får Split til at forsøge at bestemme størrelsen af
  357.        sit input med funktionen Seek() fra dos.library.  Hvis
  358.        man gør det vil man sandsynligvis ende med en mængde
  359.        små filer med typisk én oktet i hver.
  360.  
  361.    SE OGSÅ
  362.        CONCAT, JOIN, TYPE
  363.  
  364. dansk:TEE                                                   dansk:TEE
  365.  
  366.    FORMAT
  367.        TEE [[TO] <filer>] [APPEND] [IGNORE]
  368.  
  369.    SKABELON
  370.        TO/M,APPEND/S,IGNORE/S
  371.  
  372.    FORMÅL
  373.        Tee er en rørfitting.
  374.  
  375.    SPECIFIKATION
  376.        Tee transskiberer sit standardinput til sit standardoutput
  377.        og laver kopier i de filer der angives med argumentet TO.
  378.  
  379.        Med kontakten APPEND tilføjes uddata til filerne fremfor
  380.        at overskrive dem.
  381.  
  382.        Ctrl-C'er kan ignoreres ved at bruge kontakten IGNORE.
  383.  
  384. dansk:TIMECOM                                           dansk:TIMECOM
  385.  
  386.    FORMAT
  387.        TIMECOM [TO <logfil> [APPEND]] [COMMAND] <kommandolinje>
  388.  
  389.    SKABELON
  390.        TO/K,APPEND/S,COMMAND/F/A
  391.  
  392.    FORMÅL
  393.        At tage tid på en kommando.
  394.  
  395.    SPECIFIKATION
  396.        Argumentet <kommandolinje> udføres.  Når det er færdig
  397.        udskriver TimeCom den forløbne tid.  Tiden rapporteres i
  398.        sekunder.
  399.  
  400.        Tiden udskrives på CONSOLE: medmindre argumentet TO bruges
  401.        til at angive en uddatafil.  Kontakten APPEND tilføjer
  402.        uddata til slutningen uddatafilen.  Dette er nyttigt til
  403.        at føre en logfil over kørselstiderne for flere
  404.        kommandoer.
  405.  
  406.    EKSEMPLER
  407.            1> TIMECOM MitProgram
  408.            Elapsed time: 23 seconds.
  409.  
  410.            1> TIMECOM TO tidslog APPEND MitProgram
  411.            1> TYPE tidslog
  412.            Elapsed time: 23 seconds. Command: MitProgram
  413.  
  414.            1> ALIAS MitProgram "TIMECOM TO logfil APPEND MitProgram"
  415.            1> MitProgram
  416.  
  417.    ADVARSEL
  418.        Tiderne er ikke ekstremt nøjagtige.
  419.  
  420.    SE OGSÅ
  421.        intuition.library/CurrentTime
  422.        i `ROM Kernel Reference Manual: Includes and Autodocs.'
  423.  
  424. dansk:UNIQUE                                             dansk:UNIQUE
  425.  
  426.    FORMAT
  427.        UNIQUE [[FROM] <fil>] [[TO] <fil>] [REPEATED][UNIQUE][COUNT]
  428.  
  429.    SKABELON
  430.        FROM,TO,REPEATED/S,UNIQUE/S,COUNT/S
  431.  
  432.    FORMÅL
  433.        At rapportere gentagne linjer i en fil.
  434.  
  435.    SPECIFIKATION
  436.        Kommandoen Unique læser filen FROM og sammenligner
  437.        tilstødende linjer.  I det normale tilfælde fjernes den
  438.        anden og efterfølgende kopier af gentagne linjer.
  439.        Resten af filen skrives til filen TO.  Bemærk at gentagne
  440.        linjer skal stå lige efter hinanden for at blive fundet
  441.        (se SORT).  Hvis kontakten UNIQUE bruges bliver kun de
  442.        linjer der ikke er gentaget i den oprindelige fil
  443.        udskrevet.  Kontakten REPEATED angiver at én kopi af kun
  444.        de gentagne linjer skal udskrives.  Den normale adfærd
  445.        er at udskrive foreningsmængden af hvad UNIQUE og
  446.        REPEATED ville producere.
  447.  
  448.        Kontakten COUNT frembringer en uddatarapport hvor hver
  449.        linje er foranstillet antallet af gange den forekom.
  450.  
  451.        Hvis argumentet FROM ikke er angivet, læses inddata fra
  452.        standardinputtet.  Ligeledes skrives uddata til standard-
  453.        outputtet hvis argumentet TO er udeladt.
  454.  
  455.    SE OGSÅ
  456.        COMMON, COUNT, SORT
  457.  
  458.    FEJL OG MANGLER
  459.        Unique vil ikke virke korrekt hvis nogle inddatalinjer
  460.        er længere end 512 tegn.
  461.  
  462.    TILSVARENDE I UNIX
  463.        uniq(BU_CMD)
  464.  
  465. English:--Introduction--                     English:--Introduction--
  466.  
  467.    PURPOSE
  468.        To give a brief introduction to the extra AmigaDOS commands.
  469.  
  470.    SPECIFICATION
  471.        The commands in this distribution were written to augment
  472.        the collection distributed by Commodore-Amiga, Inc. as part
  473.        of the System Software Release 2.04 (V37) and will not run
  474.        under older releases.
  475.  
  476.        Though they are generally modelled after equivalent UNIX
  477.        commands they have a substantially different interface
  478.        because they all use the standard AmigaDOS templates.
  479.  
  480.        All the commands are `pure' and can be made resident.
  481.        If the p-flags are not set when you recieve the package
  482.        you can set them with the PROTECT command.
  483.  
  484.    SEE ALSO
  485.        `The AmigaDOS Manual', 3rd. Edition, Bantam Books, 1991
  486.        and the `Using The System Software' manual distributed
  487.        with Release 2.04.
  488.  
  489.    COPYRIGHT
  490.        All the programs and other files included in this distribution
  491.        are Copyright (c) 1989, 1990, 1991, 1992 Torsten Poulin.
  492.  
  493.              The copyright messages in the commands can be
  494.              displayed by typing the following AmigaDOS command:
  495.                  1> VERSION <command> FULL
  496.  
  497.        Feel free to mess around with the source code.  If you
  498.        make any improvements, I would appreciate a copy of them
  499.        so that they can be incorporated into the next release
  500.        if appropriate. 
  501.  
  502.        This is FreeWare not ShareWare.  Feel no guilt about
  503.        using it without paying for it.  The only payment I would
  504.        really appreciate is if you could let me know about bugs
  505.        you discover.  Of course no one can make any real money
  506.        for distributing this package.  It may only be
  507.        distributed for non-commercial purposes free of charge
  508.        except for the usual __MINOR__ fee to pay for the
  509.        distribution media.
  510.  
  511.    AUTHOR'S ADDRESS
  512.        Please send suggestions, bug reports, improvements, etc.
  513.        to the following address:
  514.            Torsten Poulin
  515.            Banebrinken 99, 2, lejlighed 77
  516.            DK 2400  København NV
  517.            DENMARK
  518.  
  519.    TRADEMARKS
  520.        AmigaDOS is a registered trademark of Commodore-Amiga, Inc.
  521.        UNIX is a registered trademark of AT&T.
  522.  
  523.    ACKNOWLEDGEMENT
  524.        The wording of the following manual pages owes quite a lot
  525.        to various UNIX manuals.  I hope the folks behind UNIX
  526.        don't mind.
  527.  
  528. English:COMMON                                         English:COMMON
  529.  
  530.    FORMAT
  531.        COMMON [FILE1] <file1> [[FILE2] <file2>] [-1] [-2] [-3]
  532.  
  533.    TEMPLATE
  534.        FILE1/A,FILE2,-1/S,-2/S,-3/S
  535.  
  536.    PURPOSE
  537.        To select or reject lines common to two sorted files.
  538.  
  539.    SPECIFICATION
  540.        The command Common reads <file1> and <file2>, which should be
  541.        ordered in the collating sequence of SORT, and produces a
  542.        three-column output: lines only in <file1>; lines only in
  543.        <file2>; and lines in both files.
  544.  
  545.        Switches -1, -2, or -3 suppress printing of the corresponding
  546.        column.  Thus Common -1 -2 prints only the lines common to
  547.        the two files; Common -2 -3 prints only the lines in the first
  548.        file but not in the second; Common -1 -2 -3 is a no-op.
  549.  
  550.    SEE ALSO
  551.        SORT, UNIQUE
  552.  
  553.    UNIX EQUIVALENT
  554.        comm(BU_CMD)
  555.  
  556. English:CONCAT                                         English:CONCAT
  557.  
  558.    FORMAT
  559.        CONCAT [[FROM] <files|patterns>] [TO <name>]
  560.               [SORT] [QUIET] [VISIBLE [TABS] [EOL]] [UNBUF]
  561.  
  562.    TEMPLATE
  563.        FROM/M,TO/K,SORT/S,QUIET/S,VISIBLE/S,TABS/S,EOL/S,UNBUF/S
  564.  
  565.    PURPOSE
  566.        To concatenate and print files.
  567.  
  568.    SPECIFICATION
  569.        Concat reads each of the specified FROM files and writes it
  570.        to the destination specified by the TO option.  If no FROM
  571.        option is given Concat reads from its default input; likewise
  572.        if no TO option is specified it writes to its default output.
  573.  
  574.        The following switches apply to Concat.
  575.  
  576.        SORT    The FROM files are read in alphabetical order.
  577.                Useful when concatenating files split with Split.
  578.  
  579.        QUIET   Concat is quiet about non-existent input files.
  580.  
  581.        VISIBLE Causes non-printing characters (with the exception
  582.                of tabs and new-lines) to be printed visibly.
  583.                Control characters are printed as ^X (control-x);
  584.                the DEL character (hex 0x7d) is printed as ^?.
  585.                Non-ASCII characters (with the high bit set) are
  586.                printed as M-x, where x is the character specified
  587.                by the seven low order bits.
  588.  
  589.        UNBUF   The output is not buffered. (The default is
  590.                buffered output.)
  591.  
  592.        When used with the VISIBLE switch, the following switches
  593.        may be used.
  594.  
  595.        TABS    Causes tabs to be printed as ^I's.
  596.  
  597.        EOL     Causes a $ character to be printed at the end of
  598.                each line (prior to the new-line).
  599.  
  600.        The TABS and EOL switches are ignored if the VISIBLE
  601.        switch is not specified.
  602.  
  603.    SEE ALSO
  604.        COPY, JOIN, MORE, SPLIT, TYPE
  605.  
  606. English:COUNT                                           English:COUNT
  607.  
  608.    FORMAT
  609.        COUNT [[FROM] <names|patterns>] [LINES] [WORDS] [CHARS]
  610.  
  611.    TEMPLATE
  612.        FROM/M,LINES/S,WORDS/S,CHARS/S
  613.  
  614.    PURPOSE
  615.        To count lines, words, and characters.
  616.  
  617.    SPECIFICATION
  618.        Count counts lines, words, and characters in the named files,
  619.        or in the default input if no names appear.  It also keeps
  620.        a total count for all named files.  A word is a maximal
  621.        string of characters delimited by spaces, tabs, or new-lines.
  622.  
  623.        The switches LINES, WORDS, and CHARS may be used to specify
  624.        that a subset of lines, words, and characters are to be
  625.        reported.  If no switches are given Count defaults to
  626.        all of them.
  627.  
  628.        When names are specified on the command line, they will be
  629.        printed along with the counts.
  630.  
  631. English:DIRTREE                                       English:DIRTREE
  632.  
  633.    FORMAT
  634.        DirTree [DIR] {<directory>} [NOHEAD]
  635.  
  636.    TEMPLATE
  637.        DIR/A/M,NOHEAD/S
  638.  
  639.    PURPOSE
  640.        To print sub-directory trees.
  641.  
  642.    SPECIFICATION
  643.        DirTree displays the sub-directory trees for the directories
  644.        or volumes specified in the DIR argument.  The NOHEAD switch
  645.        suppresses the printing of the header information.
  646.  
  647.    EXAMPLE
  648.            1> DIRTREE ram:
  649.            Directory tree for "ram:" on Saturday 22-Feb-92
  650.  
  651.            Ram Disk
  652.            +---Clipboards
  653.            +---env
  654.            |   `---sys
  655.            |  
  656.            `---T
  657.  
  658.    SEE ALSO
  659.        DIR, LIST
  660.  
  661. English:HEAD                                             English:HEAD
  662.  
  663.    FORMAT
  664.        HEAD [[FROM] <files|patterns>] [TO <file>] [NUMBER <n>]
  665.  
  666.    TEMPLATE
  667.        FROM/M,TO/K,NUM=NUMBER/N/K
  668.  
  669.    PURPOSE
  670.        To display first few lines of specified files.
  671.  
  672.    SPECIFICATION
  673.        Head copies the first NUMBER lines of each FROM file to the
  674.        default output or the TO file if one is given.  If no FROM
  675.        files are given, Head copies lines from the default input.
  676.        The default number of lines is 10.
  677.  
  678.        When more than one file is specified, the start of each
  679.        file looks like:
  680.  
  681.                ==>filename<==
  682.  
  683.    EXAMPLE
  684.        A way to display a set of short files, identifying each
  685.        one, is:
  686.  
  687.            1> HEAD filename1 filename2 NUMBER 9999
  688.  
  689.    SEE ALSO
  690.        CONCAT, TAIL, TYPE
  691.  
  692.    UNIX EQUIVALENT
  693.        head(BU_CMD)
  694.  
  695. English:LOWER                                           English:LOWER
  696.  
  697.    FORMAT
  698.        LOWER [BY <value>] [STACK <size>] [COMMAND] <command line>
  699.  
  700.    TEMPLATE
  701.        BY/K/N,STACK/K/N,COMMAND/F/A
  702.  
  703.    PURPOSE
  704.        To run a command at a nice, possibly lower, priority.
  705.  
  706.    SPECIFICATION
  707.        Since the Amiga is multitasking, it uses priority numbers to
  708.        determine the order in which current tasks should be serviced.
  709.        Normally, most tasks have a priority of 0, and the time and
  710.        instruction cycles of the CPU are divided equally among them.
  711.  
  712.        LOWER executes the specified command line with the priority
  713.        lowered by <value>.  If no BY option is specified a default
  714.        value of 1 is used.  If a negative value is specified the
  715.        priority will be raised instead.  The resulting priority will
  716.        be between -128 and +10.  This is enforced silently.
  717.  
  718.        The STACK option sets the stack size of the command to be
  719.        executed.  Default is to use the current stack size.
  720.  
  721.        The <command line> is any valid shell command line; i.e. it
  722.        is possible to use redirection, aliases, resident commands
  723.        etc.
  724.  
  725.        LOWER leaves the value of the executed command in the
  726.        condition flags RC and Result2.  Ctrl-C, D, E, and F are
  727.        sent to the executed command.
  728.  
  729.        In short, the use of LOWER is tranparent.
  730.  
  731.    EXAMPLES
  732.        To print the file Text at lower priority, type:
  733.  
  734.            1> LOWER COPY Text TO PRT:
  735.  
  736.        And to search, in the background, for occurences of the
  737.        string "foo", in the S: directory, you might issue
  738.        the following:
  739.  
  740.            1> RUN LOWER BY 2 SEARCH S: "foo" TO MyOutputFile
  741.  
  742.    SEE ALSO
  743.        CHANGETASKPRI, STACK, STATUS
  744.  
  745. English:SPLIT                                           English:SPLIT
  746.  
  747.    FORMAT
  748.        SPLIT [[FROM] <file>] [TO <name>] [NUMBER <n> [PARTS]]
  749.              [BYTES] [PROMPT]
  750.  
  751.    TEMPLATE
  752.        FROM,TO/K,NUM=NUMBER/K/N,PARTS/S,BYTES/S,PROMPT/S
  753.  
  754.    PURPOSE
  755.        To split a file into pieces.
  756.  
  757.    SPECIFICATION
  758.        Split reads <file> and writes it in <n>-line pieces (default
  759.        1000 lines) onto a set of output files.  The name of the
  760.        first output file is <name> with aa appended, and so on
  761.        lexicographically, up to zz (a maximum of 676 files). <name>
  762.        is truncated to 28 characters if it is longer.  If no output
  763.        name is given, x is default.
  764.  
  765.        If the BYTES switch is used, the input file will be split in
  766.        <n>-character pieces instead.  This is especially useful
  767.        if the input is a binary file.
  768.  
  769.        The PARTS switch, which can only be used in conjunction with
  770.        the NUMBER option, splits the input file in the specified
  771.        number of parts.
  772.  
  773.        The PARTS switch implies the BYTES switch.
  774.  
  775.        If the PROMPT switch is specified, the user will be prompted
  776.        before each output file is written, to make it possible to
  777.        change disks.
  778.  
  779.        If no input file is given then the default input is used
  780.        making it possible to use Split as the end of a pipe-line.
  781.        
  782.    EXAMPLE
  783.        If the file `myfile' is split up with a command like this:
  784.            1> SPLIT myfile TO splitfile.
  785.        it can be assembled again with the following command:
  786.            1> CONCAT splitfile.?? TO newfile SORT
  787.  
  788.    WARNING
  789.        Do not use the PARTS switch if reading from a pipe as
  790.        it causes Split to attempt to determine the size of it's
  791.        input using the dos.library function Seek().  If you do
  792.        it chances are that you end up with lots of small files
  793.        typically containing one byte each.
  794.  
  795.    SEE ALSO
  796.        CONCAT, JOIN, TYPE
  797.  
  798. English:TEE                                               English:TEE
  799.  
  800.    FORMAT
  801.        TEE [[TO] <files>] [APPEND] [IGNORE]
  802.  
  803.    TEMPLATE
  804.        TO/M,APPEND/S,IGNORE/S
  805.  
  806.    PURPOSE
  807.        Tee is a pipe fitting.
  808.  
  809.    SPECIFICATION
  810.        Tee transcribes the default input to the default output and
  811.        makes copies in the files specified by the TO option.
  812.  
  813.        The APPEND switch causes the output to be appended to the
  814.        files rather than overwriting them.
  815.  
  816.        Ctrl-C's can be ignored by giving the IGNORE switch.
  817.  
  818. English:TIMECOM                                       English:TIMECOM
  819.  
  820.    FORMAT
  821.        TIMECOM [TO <log file> [APPEND]] [COMMAND] <command line>
  822.  
  823.    TEMPLATE
  824.        TO/K,APPEND/S,COMMAND/F/A
  825.  
  826.    PURPOSE
  827.        To time a command.
  828.  
  829.    SPECIFICATION
  830.        The <command line> is executed; after it is complete, TimeCom
  831.        prints the elapsed time during the command.  The time is
  832.        reported in seconds.
  833.  
  834.        The time is printed on CONSOLE: unless the TO option is used
  835.        to specify an output file.  The APPEND switch adds the output
  836.        to the end of the specified output file.  This is useful for
  837.        keeping a log of the execution times of several commands.
  838.  
  839.    EXAMPLES
  840.            1> TIMECOM MyProgram
  841.            Elapsed time: 23 seconds.
  842.  
  843.            1> TIMECOM TO timelog APPEND MyProgram
  844.            1> TYPE timelog
  845.            Elapsed time: 23 seconds. Command: MyProgram
  846.  
  847.            1> ALIAS MyProgram "TIMECOM TO log APPEND MyProgram"
  848.            1> MyProgram
  849.  
  850.    WARNING
  851.        The time value is not extremely accurate.
  852.  
  853.    SEE ALSO
  854.        intuition.library/CurrentTime
  855.        in `ROM Kernel Reference Manual: Includes and Autodocs.'
  856.  
  857. English:UNIQUE                                         English:UNIQUE
  858.  
  859.    FORMAT
  860.        UNIQUE [[FROM] <file>] [[TO] <file>] [REPEATED][UNIQUE][COUNT]
  861.  
  862.    TEMPLATE
  863.        FROM,TO,REPEATED/S,UNIQUE/S,COUNT/S
  864.  
  865.    PURPOSE
  866.        To report repeated lines in a file.
  867.  
  868.    SPECIFICATION
  869.        The command Unique reads the FROM file comparing adjacent
  870.        lines.  In the normal case, the second and succeeding copies
  871.        of repeated lines are removed; the remainder is written
  872.        on the TO file.  Note that repeated lines must be adjacent
  873.        to be found (see SORT).  If the UNIQUE switch is used, just
  874.        the lines that are not repeated in the original file are
  875.        output.  The REPEATED switch specifies that one copy of just
  876.        the repeated lines is to be written.  The normal mode ouput
  877.        is the union of the UNIQUE and REPEATED mode outputs.
  878.  
  879.        The COUNT switch generates an output report with each line
  880.        preceeded by a count of the number of times it occured.
  881.  
  882.        If no FROM file is given input is read from the default
  883.        input;  likewise if no TO file is given output is written
  884.        to the default output.
  885.  
  886.    SEE ALSO
  887.        COMMON, COUNT, SORT
  888.  
  889.    BUGS
  890.        Unique will fail to function correctly given input lines
  891.        longer than 512 characters.
  892.  
  893.    UNIX EQUIVALENT
  894.        uniq(BU_CMD)
  895.  
  896.  
  897.