home *** CD-ROM | disk | FTP | other *** search
/ Sams Teach Yourself C in 21 Days (6th Edition) / STYC216E.ISO / pc / DJGPP / dsm-spec.txt < prev    next >
Text File  |  2000-05-03  |  25KB  |  939 lines
  1. Copyright (C) 1999, 2000 by Richard Dawe
  2.  
  3.  
  4.  
  5. Introduction
  6. ************
  7.  
  8. DJGPP has a lot of packages, and is becoming more and more popular.
  9. This is a testament to those who have worked on it & helped with it,
  10. and continue to do so (thanks guys & gals). However, for new users, it
  11. can be tricky to install and configure.  Even for old users, it is
  12. somtimes a lot of hassle to install/remove packages ;) So, it would be
  13. nice to have some (standard) way of simplifying this process. The DJGPP
  14. Software Manifest, hopefully, will allow this.
  15.  
  16. DJGPP software often comes with a "manifest file", with a file extension
  17. of `.mft', which lists the files contained in the package, and a
  18. "version file", with a file extension of `.ver', which has a brief
  19. description of the package, often containing no more than the name and
  20. version.
  21.  
  22. It would be useful to have a standard way of describing DJGPP packages,
  23. so that they could be installed/uninstalled/queried by a "package
  24. manager", taking into account any interactions between the packages.
  25. The description would also include more information about the package
  26. than the current manifest & version files do.
  27.  
  28. Before going any further, the term "package" should be defined in the
  29. context of this specification. A "package" is a compressed archive
  30. containing a file or files describing the package. Thus, the files in
  31. the current DJGPP archive qualify as packages because they contain
  32. manifest and version files.
  33.  
  34. DJGPP packages are distributed as binaries (pre-compiled), sources
  35. (compilation required) or documentation (reading required).
  36.  
  37. DJGPP Software Manifest
  38. =======================
  39.  
  40. The name DJGPP Software Manifest (DSM) has been chosen for the
  41. description.  This is stored in a "DSM file", with a file extension of
  42. `.dsm'. This will provide the following information about a package:
  43.  
  44.    * Package name, version, type, short and long descriptions;
  45.  
  46.    * Names of binary, source or documentation DSMs for this package;
  47.  
  48.    * License, author, organisation, maintainer, porter, mailing list
  49.      and newsgroup information;
  50.  
  51.    * Home page, download site, location on DJGPP archive;
  52.  
  53.    * Location of informational files in the package;
  54.  
  55.    * Dependency of package on other packages, e.g. requirements,
  56.      clashes;
  57.  
  58. If the package contains a DSM file, it should be stored in either the
  59. top-level directory (the base directory of the archive) or in
  60. `manifest/' off the top-level directory. This ensures that the package
  61. managers can easily find the DSM.
  62.  
  63. DSM File Syntax
  64. ***************
  65.  
  66. Syntax
  67. ======
  68.  
  69. Directives
  70. ----------
  71.  
  72. A DSM is a plain text file. It describes the package using directives.
  73. A "directive" is a name, consisting only of alphanumeric and hyphen
  74. characters, e.g. `short-description'. A directive takes a single value
  75. and is separated from it by a colon, e.g.:
  76.  
  77.      short-description: V. short
  78.  
  79. Directives are single-valued - to have multiple values, the directive
  80. should be used more than once. This is not allowed with all directives.
  81. *Note Multiply-Allowed Directives::. If the directives have some logical
  82. grouping, e.g. when describing package authors, then different
  83. directives are associated by occurrence in the DSM, e.g. the third
  84. `author-email' directive refers the third author's e-mail address.
  85.  
  86. Line Continuation & Escaping
  87. ----------------------------
  88.  
  89. It may be desirable to have more than one line of data for some of the
  90. directives, e.g. `short-description'. The line continuation character is
  91. a backslash, \. This should be the last non-whitespace character on the
  92. line.
  93.  
  94. In the informational directives `short-description' and
  95. `long-description', C-style escapes can be used to insert newlines, etc.
  96. into the directive. The following escapes should be supported:
  97.  
  98. `\n'
  99.      Newline
  100.  
  101. `\t'
  102.      Tab
  103.  
  104. `\\'
  105.      Backslash
  106.  
  107. Formats
  108. -------
  109.  
  110. The "version number" must be specified as follows:
  111.  
  112.      <Major>[.<Minor>[.<Subminor>[.<Subsubminor>]]]
  113.      [(alpha <Alpha number>) | (beta <Beta number>)]
  114.      [revision <Revision number>] [patchlevel <Patchlevel number>]
  115.      [snapshot <ISO 8061 hyphenless date>] [platform <Platform specifier>]
  116.  
  117. The components must be in this order. NB: The versions 1.0.0 and 1.0
  118. may seem to be the same, but are not.
  119.  
  120. The "ISO 8061 hyphenless date" is specified by `YYYYMMDD', where `YYYY'
  121. is the 4-digit year, `MM' is the 2-digit month number and `DD' is the
  122. 2-digit day number (in the month), all padded with zeroes as necessary.
  123.  
  124. The "platform" is a `<CPU>-<Manufacturer>-<Operating System>' triplet
  125. or `<CPU>-<Manufacturer>-<Kernel>-<Operating System>' quadruplet
  126. describing the hardware & software that the package works on. This
  127. format is used by autoconf for its `--host', `--target' and `--build'
  128. options. For DJGPP the platform is usually `i386-pc-msdosdjgpp'. The CPU
  129. could be `i486', `i586' for Pentium-class CPUs or `i686' for Pentium
  130. II-class CPUs.
  131.  
  132. Descriptive Directives
  133. ======================
  134.  
  135. DSM Header
  136. ----------
  137.  
  138. The following fields comprise the DSM header:
  139.  
  140. `dsm-file-version'
  141.      This specifies the revision of this file, e.g. 1, 0.1 - do not
  142.      confuse this with `dsm-version'. This allows the user to check for
  143.      new versions of a package's DSM file.
  144.  
  145. `dsm-version'
  146.      DSM format version number, e.g. 0.4.0, the version of this
  147.      specification.
  148.  
  149. `dsm-name'
  150.      DSM name = file name without extension
  151.  
  152. `dsm-type'
  153.      (binaries|sources|documentation|group|virtual)
  154.  
  155. The different DSM types are defined as follows:
  156.  
  157. `binaries'
  158.      The package primarily contains executable programs.
  159.  
  160. `sources'
  161.      The package primarily contains source code.
  162.  
  163. `documentation'
  164.      The package primarily contains documentation.
  165.  
  166. `group'
  167.      The DSM refers to a collection of related packages. This is so
  168.      that, for example, the whole of GNU emacs could be installed by
  169.      referring to its group DSM. A group package is, in a way, a
  170.      meta-package. A group package is implemented by using the
  171.      `requires' directive.
  172.  
  173. `virtual'
  174.      A virtual package refers to facilities that are outside the domain
  175.      of a package manager, e.g. there could be a virtual package for
  176.      Microsoft Windows.  A virtual package is implemented by using the
  177.      `provides' directive.
  178.  
  179. The following fields comprise the DSM author information header:
  180.  
  181. `dsm-author'
  182.      DSM author's name
  183.  
  184. `dsm-author-email'
  185.      DSM author's e-mail address
  186.  
  187. `dsm-author-im'
  188.      DSM author's instant messaging details, e.g for ICQ
  189.  
  190. `dsm-author-web-site'
  191.      DSM author's web site
  192.  
  193. `dsm-author-ftp-site'
  194.      DSM author's FTP site
  195.  
  196. These fields are needed because the DSM may not have been written by the
  197. person(s) who made the package.
  198.  
  199. Information Directives
  200. ----------------------
  201.  
  202. The following fields give more detailed information about the package
  203. itself.  The version information is particularly important.
  204.  
  205. In the `binaries-dsm', `source-dsm' and `documentation-dsm' fields
  206. below, it is not necessary that the version for those packages will be
  207. the same as for this package, i.e. specified by `version'.
  208.  
  209. `name'
  210.      This specifies the package name, which cannot contain whitespace.
  211.      Instead use hyphens or underscores.
  212.  
  213. `version'
  214.      Version number
  215.  
  216. `manifest'
  217.      Manifest, .mft, file name without extension
  218.  
  219. `binaries-dsm'
  220.      Binaries DSM name, file name without extension
  221.  
  222. `sources-dsm'
  223.      Sources DSM name, file name without extension
  224.  
  225. `documentation-dsm'
  226.      Documentation DSM name, file name without extension
  227.  
  228. `short-description'
  229.      One line of text
  230.  
  231. `long-description'
  232.      Multiple lines of text
  233.  
  234. `license'
  235.      Package's license, e.g. GNU General Public License, BSD License
  236.  
  237. `organisation'
  238.      e.g. FSF
  239.  
  240. `author'
  241.      Author's name for this package
  242.  
  243. `author-email'
  244.      Author's e-mail address
  245.  
  246. `author-im'
  247.      Author's instant messaging details, e.g. for ICQ
  248.  
  249. `web-site'
  250.      Home page for the package or author - this should give the
  251.      complete URL, e.g. `http://www.grossprojekt.org/'.
  252.  
  253. `ftp-site'
  254.      Download site of the package or author - this should give the
  255.      complete URL, e.g. `ftp://ftp.grossprojekt.org/'.
  256.  
  257. `maintainer'
  258.      Maintainer's name
  259.  
  260. `maintainer-email'
  261.      Maintainer's e-mail address
  262.  
  263. `maintainer-im'
  264.      Maintainer's instant messaging details, e.g. for ICQ
  265.  
  266. `maintainer-web-site'
  267.      Maintainer's home page
  268.  
  269. `maintainer-ftp-site'
  270.      Maintainer's FTP site
  271.  
  272. `porter'
  273.      Porter's name
  274.  
  275. `porter-email'
  276.      Porter's e-mail address
  277.  
  278. `porter-im'
  279.      Porter's instant messaging details, e.g. for ICQ
  280.  
  281. `porting-web-site'
  282.      Home page for the port, with complete URL.
  283.  
  284. `porting-ftp-site'
  285.      Download site for the port, with complete URL.
  286.  
  287. `mailing-list'
  288.      Mailing list's e-mail address
  289.  
  290. `mailing-list-description'
  291.      Description of the Mailing list
  292.  
  293. `mailing-list-request'
  294.      E-mail address to which request subscription requests should be
  295.      sent. Details for how to use this should be on the mailing list's
  296.      web site.
  297.  
  298. `mailing-list-administrator'
  299.      Mailing list administrator's name
  300.  
  301. `mailing-list-administrator-email'
  302.      Mailing list administrator's e-mail address
  303.  
  304. `mailing-list-administrator-im'
  305.      Mailing list administrator's instant messaging details, e.g. for
  306.      ICQ
  307.  
  308. `mailing-list-web-site'
  309.      Mailing list home page, with complete URL - this should contain
  310.      details of how to join the list.
  311.  
  312. `mailing-list-ftp-site'
  313.      Mailing list download site, with complete URL.
  314.  
  315. `newsgroup'
  316.      Newsgroup for the package
  317.  
  318. `newsgroup-description'
  319.      Description of the newsgroup
  320.  
  321. `newsgroup-email-gateway'
  322.      This is an e-mail address to send newsgroup items to. The e-mail
  323.      will be converted into a newsgroup posting. An example for DJGPP is
  324.      `djgpp@delorie.com'.
  325.  
  326. `newsgroup-administrator'
  327.      Newsgroup administrator's name
  328.  
  329. `newsgroup-administrator-email'
  330.      Newsgroup administrator's e-mail address
  331.  
  332. `newsgroup-administrator-im'
  333.      Newsgroup administrator's instant messaging details, e.g. for ICQ
  334.  
  335. `newsgroup-web-site'
  336.      Newsgroup home page, with complete URL.
  337.  
  338. `newsgroup-ftp-site'
  339.      Newsgroup download site, with complete URL.
  340.  
  341. Installion & Dependency Directives
  342. ==================================
  343.  
  344. Package Archive Information
  345. ---------------------------
  346.  
  347. `simtelnet-path'
  348.      This is the location of the package's archive in the DJGPP FTP
  349.      structure, e.g. v2tk/ . This is for automatic FTP or HTTP
  350.      downloading by the package manager. The trailing slash is optional.
  351.  
  352. `zip'
  353.      This specifies the archive file names in preferred order of
  354.      installation. The file extension must be `.zip' and must be
  355.      present in this field.
  356.  
  357. `tar-gzip'
  358.      This specifies the archive File names in preferred order of
  359.      installation. The file extension must be one of `.tgz', `.taz' or
  360.      `.tar.gz' and must be present in this field.
  361.  
  362. `changelog'
  363.      This specifies the relative path in the archive to the changelog,
  364.      for use by the package manager.
  365.  
  366. `pre-install-readme'
  367.      This specifies the relative path in the archive to "readme" file
  368.      for pre-install information.
  369.  
  370. `post-install-readme'
  371.      This specifies the relative path in the archive to "readme" file
  372.      for post-install information.
  373.  
  374. `pre-uninstall-readme'
  375.      This specifies the relative path in the archive to "readme" file
  376.      for pre-uninstall information.
  377.  
  378. `post-uninstall-readme'
  379.      This specifies the relative path in the archive to "readme" file
  380.      for post-uninstall information.
  381.  
  382. `builtin-pre-install-script'
  383.      [Built-in scripting]
  384.  
  385. `builtin-post-install-script'
  386.      [Built-in scripting]
  387.  
  388. `builtin-pre-uninstall-script'
  389.      [Built-in scripting]
  390.  
  391. `builtin-post-uninstall-script'
  392.      [Built-in scripting]
  393.  
  394. *Note Scripting:: for a definition of the built-in scripting language.
  395.  
  396. `pre-install-script'
  397.      [File name, extracted from zip/tgz]
  398.  
  399. `post-install-script'
  400.      [File name]
  401.  
  402. `pre-uninstall-script'
  403.      [File name]
  404.  
  405. `post-uninstall-script'
  406.      [File name]
  407.  
  408. The script files can be in any scripting language, so long as the
  409. scripting host can be invoked by DOS programs. If this is not the case,
  410. then any DOS package manager will fail to install/uninstall. A
  411. `requires' directive should be used to ensure that the script can be
  412. run.
  413.  
  414. `prefix'
  415.      If the archive isn't structured to fit into the DJGPP tree, then a
  416.      prefix can be specified to cope with this; e.g. if all the files
  417.      are in the directory `demopkg/' in the archive, the `prefix' could
  418.      be `contrib/' to put them into `contrib/demopkg/' off the DJGPP
  419.      directory. `prefix' should be a relative path. The trailing slash
  420.      is optional.
  421.  
  422. Dependencies
  423. ------------
  424.  
  425. <Operator> can be any of the C operators  ==, <=, >=, !=, <, >.
  426. Omission of <Operator> implies an equality test. Omission of <Operator>
  427. and <Version> implies any version of the package.
  428.  
  429. A package does not automatically clash with other versions of itself.
  430.  
  431. `requires'
  432.      <Package> [[<Operator>] <Version>]
  433.      _or_ <Feature> [[<Operator>] [<Version>]][: <Qualifier>]
  434.  
  435. `depends-on'
  436.      <Package> [[<Operator>] <Version>]
  437.      _or_ <Feature> [[<Operator>] [<Version>]][: <Qualifier>]
  438. `conflicts-with'
  439.      <Package> [[<Operator>] <Version>]
  440.      _or_ <Feature> [[<Operator>] [<Version>]][: <Qualifier>]
  441.  
  442. `replaces'
  443.      <Package> [[<Operator>] <Version>]
  444.  
  445. `duplicate-action'
  446.      (replace|backup|keep|skip|query)
  447.  
  448. `depends-on' has a different emphasis than `requires'. A package
  449. `requires' another to function *at all*. If it `depends-on' then some
  450. of its functionality may not be available.
  451.  
  452. The default `duplicate-action' will depend on the installation utility.
  453.  
  454. `provides'
  455.      <Feature> [[<Operator>] [<Version>]][: <Qualifier>]
  456.  
  457. The `provides' directive is used to indicate the provision of certain
  458. features by the package. These can then be used in the `requires',
  459. `depends-on' and `conflicts-with' dependencies above. Virtual packages
  460. can use `provides' to indicate features that are available by default,
  461. e.g. the DPMI 0.9 support provided by Windows DOS boxes.
  462.  
  463. If the package provides only certain parts of a standard, e.g. CWSDPMI's
  464. support of some DPMI 1.0 function calls, then the optional qualifier
  465. can be used to indicate these. It is suggested that these take the form
  466. of `function 0x0501' or `function gethostbyname_r()'. Acronyms should
  467. be written in uppercase. *Note Standard Provisions:: for the 'provides'
  468. defined so far. The use of feature qualifiers should be co-ordinated by
  469. incorporation into this specification.
  470.  
  471. The feature name is like a package name, and so cannot contain
  472. whitespace - please use hyphens or underscores instead.
  473.  
  474. `install-before'
  475.      <Package> [[<Operator>] <Version>]
  476.  
  477. `install-after'
  478.      <Package> [[<Operator>] <Version>]
  479.  
  480. `install-warning'
  481.      Message
  482.  
  483. DSM File Structure
  484. ==================
  485.  
  486.    * A group of packages has a DSM entry with a name such as "C
  487.      development" and a list of 'requires' fields.
  488.  
  489.    * A virtual package has a DSM entry with a name such as "Windows 95"
  490.      and a list of 'provides' fields such as `provides: DPMI 0.9'.
  491.  
  492.  
  493. It is recommended that the DSM's author writes their name and contact
  494. details at the start of each DSM as a comment, in addition to the
  495. `dsm-author', etc. fields.
  496.  
  497. Required Fields
  498. ---------------
  499.  
  500. `dsm-author'
  501.  
  502. `dsm-file-version'
  503.  
  504. `dsm-version'
  505.  
  506. `dsm-name'
  507.  
  508. `dsm-type'
  509.  
  510. `name'
  511.  
  512. `version'
  513.  
  514. `short-description'
  515.  
  516. `simtelnet-path'
  517.      This is only needed if it's a binaries, documentation or sources
  518.      package that is actually in (or will be in) the Simtelnet archive.
  519.  
  520. `zip or tar-gzip'
  521.      This is only needed if it's a binaries, documentation or sources
  522.      package.
  523.  
  524. Any known `requires', `depends-on', `replaces', `install-before' or
  525. `install-after' dependencies are also required.
  526.  
  527. Multiply-Allowed Directives
  528. ---------------------------
  529.  
  530. The following directives are allowed multiply:
  531.  
  532. `author'
  533.  
  534. `author-email'
  535.  
  536. `author-im'
  537.  
  538. `web-site'
  539.  
  540. `ftp-site'
  541.  
  542. `maintainer'
  543.  
  544. `maintainer-email'
  545.  
  546. `maintainer-im'
  547.  
  548. `maintainer-web-site'
  549.  
  550. `maintainer-ftp-site'
  551.  
  552. `porter'
  553.  
  554. `porter-email'
  555.  
  556. `porter-im'
  557.  
  558. `porter-web-site'
  559.  
  560. `porter-ftp-site'
  561.  
  562. `mailing-list'
  563.  
  564. `mailing-list-description'
  565.  
  566. `mailing-list-request'
  567.  
  568. `mailing-list-administrator'
  569.  
  570. `mailing-list-administrator-email'
  571.  
  572. `mailing-list-administrator-im'
  573.  
  574. `mailing-list-web-site'
  575.  
  576. `mailing-list-ftp-site'
  577.  
  578. `newsgroup'
  579.  
  580. `newsgroup-description'
  581.  
  582. `newsgroup-email-gateway'
  583.  
  584. `newsgroup-administrator'
  585.  
  586. `newsgroup-administrator-email'
  587.  
  588. `newsgroup-administrator-im'
  589.  
  590. `newsgroup-web-site'
  591.  
  592. `newsgroup-ftp-site'
  593.  
  594.  
  595. `zip'
  596.  
  597. `tar-gzip'
  598.  
  599.  
  600. `requires'
  601.  
  602. `depends-on'
  603.  
  604. `conflicts-with'
  605.  
  606. `replaces'
  607.  
  608. `provides'
  609.  
  610. `install-before'
  611.  
  612. `install-after'
  613. An example is the case where a package has multiple authors:
  614.  
  615.      author: Fred Bloggs
  616.      author-email: fred.bloggs@bigcorp.co.uk
  617.      author: Ed Wiggins
  618.      author-email: ed.wiggins@bigcorp.co.uk
  619.  
  620. Scripting
  621. =========
  622.  
  623. The built-in scripting language isn't intended for complex operations.
  624. For that, external scripting should be used. The following commands are
  625. supported in the `builtin-pre-install-script',
  626. `builtin-post-install-script', `builtin-pre-uninstall-script' and
  627. `builtin-post-uninstall-script' directives.
  628.  
  629. `echo'
  630.      <Arguments>
  631.  
  632.  
  633.      This displays/outputs `Arguments'. This could be used to remind
  634.      the user to read the fine manual.
  635.  
  636.  
  637. `command'
  638.      <Program> <Arguments>
  639.  
  640.  
  641.      This executes `Program' by passing `Arguments' to it. This could be
  642.      used to run `install-info'  - *Note Texinfo: (texinfo)Invoking
  643.      install-info.
  644.  
  645.  
  646. Here is a simple example:
  647.  
  648.      builtin-post-install-script: command: echo Hello Mum!
  649.  
  650. Standard Provisions
  651. ===================
  652.  
  653. `DPMI 0.9'
  654.  
  655. `DPMI 1.0'
  656.  
  657. `DPMI 1.0: function 0x0506'
  658.  
  659. `DPMI 1.0: function 0x0507'
  660.  
  661. `DPMI 1.0: function 0x0508'
  662.  
  663. `DPMI 1.0: function 0x0509'
  664.  
  665. `DPMI 1.0: function 0x0E01'
  666.  
  667. `info-reader'
  668.      This denotes ability to read documentation in info format.
  669.  
  670. `LFN'
  671.      This denotes the Windows '95 Long FileName API for DOS boxes.
  672.  
  673. Concept Index
  674. *************
  675.  
  676. binaries package:
  677.           See ``DSM File Syntax''.
  678. dependency qualification:
  679.           See ``Installion & Dependency Directives''.
  680. dependency qualifier:
  681.           See ``Installion & Dependency Directives''.
  682. directive:
  683.           See ``DSM File Syntax''.
  684. directives:
  685.           See ``DSM File Syntax''.
  686. documentation package:
  687.           See ``DSM File Syntax''.
  688. DSM file:
  689.           See ``Introduction''.
  690. escape characters:
  691.           See ``DSM File Syntax''.
  692. escaping:
  693.           See ``DSM File Syntax''.
  694. feature:
  695.           See ``Installion & Dependency Directives''.
  696. features:
  697.           See ``Installion & Dependency Directives''.
  698. group package:
  699.           See ``DSM File Syntax''.
  700. ISO 8061 date:
  701.           See ``DSM File Syntax''.
  702. line continutation:
  703.           See ``DSM File Syntax''.
  704. manifest file:
  705.           See ``Introduction''.
  706. multiple values:
  707.           See ``DSM File Syntax''.
  708. package:
  709.           See ``Introduction''.
  710. package manager:
  711.           See ``Introduction''.
  712. platform:
  713.           See ``DSM File Syntax''.
  714. sources package:
  715.           See ``DSM File Syntax''.
  716. version file:
  717.           See ``Introduction''.
  718. version number:
  719.           See ``DSM File Syntax''.
  720. virtual package:
  721.           See ``DSM File Syntax''.
  722. Variable Index
  723. **************
  724.  
  725. author:
  726.           See ``DSM File Syntax''.
  727. author-email:
  728.           See ``DSM File Syntax''.
  729. author-im:
  730.           See ``DSM File Syntax''.
  731. binaries:
  732.           See ``DSM File Syntax''.
  733. binaries-dsm:
  734.           See ``DSM File Syntax''.
  735. builtin-post-install-script:
  736.           See ``Installion & Dependency Directives''.
  737. builtin-post-uninstall-script:
  738.           See ``Installion & Dependency Directives''.
  739. builtin-pre-install-script:
  740.           See ``Installion & Dependency Directives''.
  741. builtin-pre-uninstall-script:
  742.           See ``Installion & Dependency Directives''.
  743. changelog:
  744.           See ``Installion & Dependency Directives''.
  745. command:
  746.           See ``Scripting''.
  747. conflicts-with:
  748.           See ``Installion & Dependency Directives''.
  749. depends-on:
  750.           See ``Installion & Dependency Directives''.
  751. documentation:
  752.           See ``DSM File Syntax''.
  753. documentation-dsm:
  754.           See ``DSM File Syntax''.
  755. DPMI 0.9:
  756.           See ``Standard Provisions''.
  757. DPMI 1.0:
  758.           See ``Standard Provisions''.
  759. DPMI 1.0: function 0x0506:
  760.           See ``Standard Provisions''.
  761. DPMI 1.0: function 0x0507:
  762.           See ``Standard Provisions''.
  763. DPMI 1.0: function 0x0508:
  764.           See ``Standard Provisions''.
  765. DPMI 1.0: function 0x0509:
  766.           See ``Standard Provisions''.
  767. DPMI 1.0: function 0x0E01:
  768.           See ``Standard Provisions''.
  769. dsm-author:
  770.           See ``DSM File Syntax''.
  771. dsm-author-email:
  772.           See ``DSM File Syntax''.
  773. dsm-author-ftp-site:
  774.           See ``DSM File Syntax''.
  775. dsm-author-im:
  776.           See ``DSM File Syntax''.
  777. dsm-author-web-site:
  778.           See ``DSM File Syntax''.
  779. dsm-file-version:
  780.           See ``DSM File Syntax''.
  781. dsm-name:
  782.           See ``DSM File Syntax''.
  783. dsm-type:
  784.           See ``DSM File Syntax''.
  785. dsm-version:
  786.           See ``DSM File Syntax''.
  787. duplicate-action:
  788.           See ``Installion & Dependency Directives''.
  789. echo:
  790.           See ``Scripting''.
  791. ftp-site:
  792.           See ``DSM File Syntax''.
  793. group:
  794.           See ``DSM File Syntax''.
  795. info-reader:
  796.           See ``Standard Provisions''.
  797. install-after:
  798.           See ``Installion & Dependency Directives''.
  799. install-before:
  800.           See ``Installion & Dependency Directives''.
  801. install-warning:
  802.           See ``Installion & Dependency Directives''.
  803. LFN:
  804.           See ``Standard Provisions''.
  805. license:
  806.           See ``DSM File Syntax''.
  807. long-description:
  808.           See ``DSM File Syntax''.
  809. mailing-list:
  810.           See ``DSM File Syntax''.
  811. mailing-list-administrator:
  812.           See ``DSM File Syntax''.
  813. mailing-list-administrator-email:
  814.           See ``DSM File Syntax''.
  815. mailing-list-administrator-im:
  816.           See ``DSM File Syntax''.
  817. mailing-list-description:
  818.           See ``DSM File Syntax''.
  819. mailing-list-ftp-site:
  820.           See ``DSM File Syntax''.
  821. mailing-list-request:
  822.           See ``DSM File Syntax''.
  823. mailing-list-web-site:
  824.           See ``DSM File Syntax''.
  825. maintainer:
  826.           See ``DSM File Syntax''.
  827. maintainer-email:
  828.           See ``DSM File Syntax''.
  829. maintainer-ftp-site:
  830.           See ``DSM File Syntax''.
  831. maintainer-im:
  832.           See ``DSM File Syntax''.
  833. maintainer-web-site:
  834.           See ``DSM File Syntax''.
  835. manifest:
  836.           See ``DSM File Syntax''.
  837. name:
  838.           See ``DSM File Syntax''.
  839. newsgroup:
  840.           See ``DSM File Syntax''.
  841. newsgroup-administrator:
  842.           See ``DSM File Syntax''.
  843. newsgroup-administrator-email:
  844.           See ``DSM File Syntax''.
  845. newsgroup-administrator-im:
  846.           See ``DSM File Syntax''.
  847. newsgroup-description:
  848.           See ``DSM File Syntax''.
  849. newsgroup-email-gateway:
  850.           See ``DSM File Syntax''.
  851. newsgroup-ftp-site:
  852.           See ``DSM File Syntax''.
  853. newsgroup-web-site:
  854.           See ``DSM File Syntax''.
  855. organisation:
  856.           See ``DSM File Syntax''.
  857. porter:
  858.           See ``DSM File Syntax''.
  859. porter-email:
  860.           See ``DSM File Syntax''.
  861. porter-im:
  862.           See ``DSM File Syntax''.
  863. porting-ftp-site:
  864.           See ``DSM File Syntax''.
  865. porting-web-site:
  866.           See ``DSM File Syntax''.
  867. post-install-readme:
  868.           See ``Installion & Dependency Directives''.
  869. post-install-script:
  870.           See ``Installion & Dependency Directives''.
  871. post-uninstall-readme:
  872.           See ``Installion & Dependency Directives''.
  873. post-uninstall-script:
  874.           See ``Installion & Dependency Directives''.
  875. pre-install-readme:
  876.           See ``Installion & Dependency Directives''.
  877. pre-install-script:
  878.           See ``Installion & Dependency Directives''.
  879. pre-uninstall-readme:
  880.           See ``Installion & Dependency Directives''.
  881. pre-uninstall-script:
  882.           See ``Installion & Dependency Directives''.
  883. prefix:
  884.           See ``Installion & Dependency Directives''.
  885. provides:
  886.           See ``Installion & Dependency Directives''.
  887. replaces:
  888.           See ``Installion & Dependency Directives''.
  889. requires:
  890.           See ``Installion & Dependency Directives''.
  891. short-description:
  892.           See ``DSM File Syntax''.
  893. simtelnet-path:
  894.           See ``Installion & Dependency Directives''.
  895. sources:
  896.           See ``DSM File Syntax''.
  897. sources-dsm:
  898.           See ``DSM File Syntax''.
  899. tar-gzip:
  900.           See ``Installion & Dependency Directives''.
  901. version:
  902.           See ``DSM File Syntax''.
  903. virtual:
  904.           See ``DSM File Syntax''.
  905. web-site:
  906.           See ``DSM File Syntax''.
  907. zip:
  908.           See ``Installion & Dependency Directives''.
  909. Table of Contents
  910. *****************
  911.  
  912.  
  913.  
  914.  
  915. Introduction
  916.   DJGPP Software Manifest
  917.  
  918. DSM File Syntax
  919.   Syntax
  920.     Directives
  921.     Line Continuation & Escaping
  922.     Formats
  923.   Descriptive Directives
  924.     DSM Header
  925.     Information Directives
  926.   Installion & Dependency Directives
  927.     Package Archive Information
  928.     Dependencies
  929.   DSM File Structure
  930.     Required Fields
  931.     Multiply-Allowed Directives
  932.   Scripting
  933.   Standard Provisions
  934.  
  935. Concept Index
  936.  
  937. Variable Index
  938.  
  939.