home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / program / compiler / nasm20b / doc / nlib65.txt < prev    next >
Text File  |  2007-09-12  |  4KB  |  142 lines
  1.    ----------------------------------------------------------------------
  2.                      Copyright (C) 1990 by Natürlich!
  3.                         This file is copyrighted!
  4.                   Refer to the documentation for details.
  5.    ----------------------------------------------------------------------
  6.  
  7.    NLIB65 --- a library manager for NASM65 object files
  8.  
  9.  
  10.                         Preliminary manual for NLIB65
  11.  
  12.          Copyright © 1990 by Natürlich!
  13.             on sources, binaries and manuals
  14.  
  15.  
  16.                   »» Bang that Bit that doesn't Bang ««
  17.  
  18.  
  19.    I n t r o d u c t i o n
  20.  
  21.    NLIB65 is a portable (?) single-pass librarian that stores .O65 files.
  22.    NLIB65 currently runs on the 68000 Atari under TOS. The library
  23.    that NLIB65 produces can be used with NLINK65 to produce binary
  24.    files for the Atari 8-Bit.
  25.  
  26.  
  27.  
  28.    U s a g e
  29.  
  30.    nlib65 [-t -w][-acude][-l library][-b batchfile] <object files>
  31.  
  32.    -t    TOS switch, wait for a keypress after running
  33.  
  34.    -w    The "what the ...." switch, even though errors occured an output
  35.          file is generated.
  36.  
  37.    -b    Use linkfile to read in the names of [more] <object files>
  38.  
  39.    -l    Specify alternate output file pathname (or filename)
  40.  
  41.    -a    Add <object files> to library. Create library if it does
  42.          not exist.
  43.  
  44.    -u    Update <object files> in library. 
  45.  
  46.    -c    Create library. Kill old library if it exists.
  47.  
  48.    -e    Extract <object files> from existing library.
  49.  
  50.    -d    Delete <object files> from library.
  51.  
  52.    -v    List modules in library. -vfl shows the symbols as well.
  53.  
  54.  
  55.  
  56.    C r e a t i n g   a n d   a d d i n g   t o   a   l i b r a r y
  57.  
  58.    Type from a shell:
  59.    nlib65 -a -l <library path> <object files>
  60.  
  61.    That will create a library file <object>.l65. Use this library
  62.    furtheron with NLINK65. Using -c instead of -a destroys a possibly
  63.    existing library. It is important to note that the module name
  64.    will be the same name as the name of the object file that appeared
  65.    in the command line.
  66.  
  67.  
  68.    U p d a t i n g   a   l i b r a r y
  69.  
  70.    Type from a shell:
  71.    nlib65 -u -l <library path> <object files>
  72.  
  73.         This is like deleting a module from a library first, and then
  74.         adding a likewise named module to it. Note that the module 
  75.         might change its position in the ordering. This may be problematic
  76.         if the modules have some dependencies between themselves.
  77.  
  78.  
  79.         
  80.    L i s t i n g   t h e  l i b r a r y
  81.  
  82.    Type from a shell:
  83.    nlib65 -v -l <library path>
  84.  
  85.    This will give a listing of the modules in the library as well
  86.    as some information concerning the time the module was included
  87.    and the size of the module like:
  88.  
  89.    Modules in library:
  90.    00214 bytes [23:46-21.Dec.1990] : a
  91.    00234 bytes [23:46-21.Dec.1990] : b
  92.    00117 bytes [23:46-21.Dec.1990] : foo.o65
  93.       Size          Date             Module name
  94.  
  95.    Specify -vfl instead of -v to get the symbols included in the
  96.    module as well like
  97.  
  98.    Modules in library:
  99.    00214 bytes [23:46-21.Dec.1990] : a
  100.            DOIT     INIT
  101.    00234 bytes [23:46-21.Dec.1990] : b
  102.            FOO      START    WHERE
  103.    00117 bytes [23:46-21.Dec.1990] : foo.o65
  104.            BAR
  105.  
  106.  
  107.    E x t r a c t i n g   a   m o d u l e   f r o m   t h e   l i b r a r y
  108.  
  109.    Object files aren't "lost" in a library, they can be extracted as
  110.    well.
  111.  
  112.    Type from a shell:
  113.    nlib65 -e -l <library path> <module>
  114.  
  115.  
  116.    D e l e t i n g   f r o m   t h e   l i b r a r y
  117.  
  118.    Type from a shell:
  119.    nlib65 -d -l <library path> <module>
  120.  
  121.    That will delete <module> from <library> and write back the new
  122.    library.
  123.  
  124.  
  125.    B a t c h f i l e s
  126.  
  127.    There are solely used, because GEMDOS can only provide 128 bytes of
  128.    commandline space, and especially NLIB65 command lines tend to
  129.    need more room. The batchfile is not a real replacement for the
  130.    commandline, you can only specify a list of object files that are
  131.    to be linked. Lines that start of with a '#' are treated as comment.
  132.  
  133.    e.g.:
  134.    # Little batch file
  135.    a.o65
  136.    b.o65
  137.    c.o65
  138.    foo.o65
  139.    # That's it
  140.  
  141.  
  142.