srcredact [OPTIONS] -u audience full_file [redacted_file]
srcredact -l [full_file]
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 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
/*<guard>*/
//<guard>
C<guard>
#<guard>
%<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"
%<*ALL> ... %</ALL>
<<<<<<< /tmp/BrjXo0hMOB/full %</nobonds> Forty-five tons best old dry government bonds, suitable for furnace, gold 7 per cents., 1864, preferred. %<*nobonds> ||||||| /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.
This work was commissioned by Consumer Financial Protection Bureau, United States Treasury.
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