home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / EFFO / forum14.lzh / SOFTWARE / C / FGREP / info_fgrep < prev    next >
Text File  |  1990-12-01  |  5KB  |  111 lines
  1. $COMMENT
  2.   ***********************************************************************
  3.   *     This file is a so-called "Info" file describing a piece of      *
  4.   *   software in a standardized way using EFFO's "Info" file format.   *
  5.   *     The format provides all basic information about a program       *
  6.   *   in a well structured manner allowing automatic extraction         *
  7.   *   of important short-form data for databases and software lists     *
  8.   *   but including more detailed descriptions as well.                 *
  9.   *     The structure is formed by a set of keywords dividing the       *
  10.   *   information into different paragraphs (see syntax description     *
  11.   *   below).                                                           *
  12.   *                                                                     *
  13.   *     Many programs distributed by EFFO will include such a file.     *
  14.   *   It will be called Info_xxxx, where xxxx is the program's name.    *
  15.   *   EFFO encourages all its members and all forum participants as     *
  16.   *   well as commercial suppliers of OS-9 and OS-9000 software to      *
  17.   *   use this format to describe their software.                       *
  18.   *     An empty "form" for Info files called "Info_empty_form" will    *
  19.   *   be distributed with all EFFO disks and through the OS9-BBS.       *
  20.   *                                                                     *
  21.   *     The syntax is quite simple: Each paragraph begins with a        *
  22.   *   "keyword line" which is a line with a $-Sign in the very first    *
  23.   *   column immediately followed by the keyword itself. The rest of    *
  24.   *   the line is reserved for short comments about the paragraph's     *
  25.   *   purpose. Some paragaphs are mandatory, and some are restricted    *
  26.   *   in size to ensure that reliable database entries can be           *
  27.   *   extracted automatically from the file.                            *
  28.   *     All subseqent lines up to the next keyword line (or the         *
  29.   *   end-of-file) are forming the paragraph body, i.e the information  *
  30.   *   that belongs to the keyword.                                      *
  31.   *     The order in which the keywords appear in the text (if they     *
  32.   *   appear at all for optional paragraphs) is free with one           *
  33.   *   important exception: "$PROGRAM-NAME" always must be the first     *
  34.   *   keyword in the program description. This rule allows multiple     *
  35.   *   descriptions to be merged into a single text file without using   *
  36.   *   special delimiters in between.                                    *
  37.   *     Finally, "$COMMENT" paragraphs are provided to include          *
  38.   *   any information not related to a program description, like        *
  39.   *   this text. They can appear anywhere in the file, even before      *
  40.   *   the first "$PROGRAM-NAME".                                        *
  41.   ***********************************************************************
  42.  
  43. $PROGRAM-NAME  Name of the program (FIRST KEYWORD, <=20 chars, mandatory)
  44.   fgrep
  45.  
  46. $VERSION  Current version/revision/edition information (<=20 chars, optional)
  47.  
  48. $PURPOSE  What is the program/package for ? (<=50 chars, mandatory)
  49.   very fast grep utility
  50.  
  51. $SUMMARY  Short summary. (<=3 lines of <=80 chars each, mandatory)
  52.   find strings in text files
  53.  
  54. $KEYWORDS  Keywords for database, comma separated (<20 chars each, recommended)
  55.   find, text
  56.  
  57. $STATUS  Program status (final, beta, experimental etc) (no limit, optional)
  58.   final
  59.  
  60. $HARDWARE  System hardware dependencies (no limit, mandatory if any)
  61.   none
  62.  
  63. $SCREEN-INTERFACE  Termcap, Zterm, etc. (<40 chars, mandatory if not raw-I/O)
  64.   none
  65.  
  66. $OS-VERSION  Required/supported OS versions (<80 chars, mandatory if dependent)
  67.   developed using V2.3, should run all OS-9/68k versions
  68.  
  69. $RUNTIME-FILES  Paths of the files required at run-time (no limit, optional)
  70.  
  71. $DOCUMENTATION-FILES  Paths of documentation files (no limit, optional)
  72.   none (-> 'fgrep -?')
  73.  
  74. $SOURCE-LANGUAGE  Programming Language(s) used (<30 chars, mandatory)
  75.   C
  76.  
  77. $SOURCE-AVAILABILITY  Avaliability of source code (<30 chars, mandatory)
  78.   public
  79.  
  80. $SOURCE-FILES  Paths of the source files (no limit, optional)
  81.  
  82. $COMPILATION  How to compile the program (no limit, optional)
  83.  
  84. $AUTHOR-NAME  Name(s) ONLY of the author(s). (<=80 chars, mandatory)
  85.   from FREE SOFTWARE FOUNDATION (adaption to OS-9/68k : Stephan Paschedag)
  86.  
  87. $AVAILABILITY  Public, Shareware, Commercial ? (<=30 chars, mandatory)
  88.   public
  89.  
  90. $CONDITIONS  Conditions, e.g. Shareware fee (no limit, optional)
  91.  
  92. $COPYRIGHT  Copyright information (<=80 chars, optional)
  93.   see file COPYING !
  94.  
  95. $DISTRIBUTOR  Where can the program be obtained from ? (<=80 chars, mandatory)
  96.   EFFO
  97.  
  98. $HISTORY  The program's version/revision history (no limit, recommended)
  99.  
  100. $EXPANSION  Planned development for next version
  101.   who knows...
  102.  
  103. $INSTALLATION  How to install the program  (no limit, optional)
  104.   no special installation
  105.  
  106. $RESTRICTIONS  What definitely will NOT work (mandatory if any)
  107.  
  108. $EXPERIENCES  Experiences with the program (no limit, optional)
  109.   very good replacement for GREP and BM
  110.   is about 4times faster than BM which is 10times faster than GREP
  111.