srcredact [OPTIONS] -e audience [full_file]

       srcredact [OPTIONS] -u audience full_file [redacted_file]

       srcredact -l [full_file]

       srcredact -h|-v

       srcredact is the program to extract ``redacted versions'' of the master
       file (option -e) or to incorporate the changes in the redacted versions
       into the master file (``unredact'', option -u).

       The master file consists of chunks intended for different audiences.
       Each audience has a name, e.g. "classified", "unclssified", "expert"
       etc.  Chunks are started and stopped by guard lines.  Each guard line
       has the format (for the default TeX syntax)




       In the first cases the text following the guard is included for the
       audiences "name1", "name2", ....  In the second case it is excluded for
       these audiences.

       THere is a special audience "ALL": a wild card for all audiences.  Thus
       the idiom


       means that the chunk is excluded for all audiences but "classified"

       Exactly one of the options  -e (extract) or -u (unextract) must be
       present.  In  the extract mode the  non-option argument is  the name of
       the full file.   If it is absent, or is "-",  standard input is used.
       In the unextract mode the first non-option argument

       -c list of comment patterns
           Use the given pattern for comment lines to search for guards
           instead of the default "TeX" pattern.  The recognized patterns are:




       -d  Debug mode on.

       -e audience
           Extract the contents for the current audience into the file file.
           The cuurent audience is guessed from the file name, if the latter
           has the structure base-audience.extension, e.g.
           "report-unclassified.tex".  The key -a overrides this guess and
           should be used if the file name does not follow this pattern.  The
           file name "-" means the standard output.

       -h  Print help information and exit.

       -l  List all audiences set in the file (one per line) and exit.

       -u audience
           Take a edited file intended for the audience (the second non-option
           argument) and incorporate the changes in it into the full file (the
           first non-option argument).  If the second argument is missing,
           standard input is used instead.  As usual, "-" also means standard
           input.  Note that only one of the two file arguments in this case
           can be standard input.

       -v  Print version information and exit.

       -w on|off|1|0|true|false
           If "on", 1 or "true" (the deafult), implicitly wrap the full
           document into the guards


       The program returns 0 if successful, 1 if conflicts were found in the
       "unextract" mode and 2 in case of problems.

       Like the standard diff3(1) tool, the program may find conflicts between
       the full version and the edited one in the -u mode.  Then the resulting
       file brackets the conflicts in the usual manner, e.g.

         <<<<<<< /tmp/BrjXo0hMOB/full
         Forty-five tons best old dry government bonds, suitable for furnace, gold
         7 per cents., 1864, preferred.
         ||||||| /tmp/BrjXo0hMOB/extracted
         Forty-five tons best old dry government bonds, suitable for furnace, gold
         7 per cents., 1864, preferred.
         >>>>>>> /tmp/BrjXo0hMOB/new

       Here "full" is the full document, "extracted" is the extracted file for
       the given audience, "new" is the edited file.
       Free Software Foundation; either version 2 of the License, or (at your
       option) any later version.

       This program is distributed in the hope that it will be useful, but
       WITHOUT ANY WARRANTY; without even the implied warranty of
       General Public License for more details.

       You should have received a copy of the GNU General Public License along
       with this program; if not, write to the Free Software Foundation, Inc.,
       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA

1.0                               2015-10-24                      SRCREDACT(1)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2019 Hurricane Electric. All Rights Reserved.