srcredact - a program for redacting the sources Copyright (C) 2015 Boris Veytsman. Version 1.0 This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the 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 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 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

srcredact - a program for redacting the sources Usage: 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 (``unextract'', 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) %<name1|name2|...> or %</name1|name2|...> 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 %</ALL> %<classified> 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 redact 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 OPTIONS -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: c /<guard>/ cpp //<guard> fortran C<guard> shell #<guard> TeX %<guard> The pattern names should be separated by commas, and the list may be enclosed in quotes to prevent shell expansion, e.g -c "TeX, c, shell" -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 redacted 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 %<ALL> ... %</ALL>