home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / glibs115.zip / doc / glib.1 < prev    next >
Text File  |  1993-03-20  |  2KB  |  91 lines
  1. .ds PX \s-1POSIX\s+1
  2. .ds UX \s-1UNIX\s+1
  3. .ds AN \s-1ANSI\s+1
  4. .TH GLIB 1 "Mar 20 1993" "GLIB 1.1.5" "Utility Commands"
  5. .SH NAME
  6. glib \- Library file (.LIB) manager for IBM OS/2 2.0 with GNU GCC/2 C++ compiler
  7. .SH SYNOPSIS
  8. .B glib
  9. .I library
  10. .I command
  11. .I ...
  12. .SH COMMANDS
  13. .B -l
  14. .B -a
  15. .I object
  16. .B -d
  17. .I object
  18. .B -x
  19. .I object
  20. .B -b
  21. .I batchfile
  22. .SH DESCRIPTION
  23. .I Glib
  24. adds, extracts and deletes object files (.obj) from a library (.lib)
  25. file. The object and library file formats are described in the
  26. Microsoft application notes included with this package. Where a ".obj"
  27. extension is appropriate for an option parameter it's inclusion is
  28. optional. If omitted the default extension will be a lowercase ".obj".
  29. This default can be overriden by providing at least one extension of
  30. your own. The object name can include zero or more wildcard, "*",
  31. characters.
  32. .SH OPTIONS
  33. .I Glib
  34. accepts the following options.
  35. .TP
  36. .I library
  37. This required option defines the library to be created or opened. The
  38. option should include the .lib extension.
  39. .TP
  40. .BI \-l
  41. List the library contents. 
  42. Each module name is listed with it's public definitions.
  43. .TP
  44. .BI \-a " object"
  45. Add object to library. The object will be added to the library and the
  46. library will be rebuilt. If an object with the same name already exists
  47. in the library it will be overwritten.
  48. .TP
  49. .BI \-d " object"
  50. Delete object in library. The object will be deleted from the library
  51. and the library will be rebuilt.
  52. .TP
  53. .BI \-x " object"
  54. Extract object from libray. The object will be extracted from the
  55. library and written to filename object.
  56. .TP
  57. .BI \-b " batchfile"
  58. Read commands from batchfile. With the exception of the library any
  59. commands can be put in a batchfile. The file should contain one option
  60. parameter pair per line. No line continuation characters are needed.
  61. .SH EXAMPLES
  62. .nf
  63. List all the modules and publics in library libc.lib, add module
  64. printf.obj and extract open.obj:
  65.  
  66. .ft B
  67.     glib libc.lib -l -a printf.obj -x open
  68. .ft R
  69.  
  70. Perform exactly the same operations using a batch file instead of
  71. options on the command line:
  72.  
  73. .ft B
  74.     glib libc.lib -l -b lib.bat
  75. .ft R
  76.  
  77. The contents of the batch file, lib.bat, are:
  78.  
  79. .ft B
  80.         -a printf.obj
  81.         -x open
  82. .ft R
  83.  
  84. Use a wildcard to extract all the objects from libc.lib:
  85.  
  86. .ft B
  87.         glib libc.lib -x *.obj
  88. .ft R
  89.  
  90. .fi
  91.