w_title(strip_stx)dnl
w_doc_id(ssman)dnl
w_section(1)dnl
w_author(Panu A. Kalliokoski)dnl
w_man_desc(a simple literate programming tool)

! SYNOPSIS

''strip_stx'' [ -c /commentchars/ ] [ -B /open/  /close/ ] [ /file/  /file/ ... ]

! DESCRIPTION

''strip_stx'' takes all structured text (Stx) markup away from the
listed /files/, leaving only text in preformatted blocks.  If no files
are listed, standard input is read instead.  The result is written to
standard output.

This is intended as a simple literate programming tool: programmers may
write their programs as documents, processing them with ''stx2any'' for
documentation and publication but with ''strip_stx'' for compilation /
running the code.

More information about Stx is on the manpage of ''stx2any''.

! OPTIONS

''-c /commentchars/''::
	comment out the non-code portions (text outside preformatted
	blocks) with the given /commentchars/ at the beginning of every
	line.  If this option (or the next one) is not given, non-code
	portions are simply deleted.

''-B /open/  /close/''::
	surround the non-code portions with (comment-)opening and
	closing markers /open/ and /close/ respectively.  This option
	can be used together with the ''-c'' option.

''--version'', ''-V''::
	Just show version information and exit.
''--help'', ''-?''::
	Just show a short help message and exit.

! EXAMPLES

  ''strip_stx parse.py.stx w_gt parse.py''

Strip documentation away from the source file ''parse.py.stx'',
supposedly only leaving python code there.

  ''strip_stx -B '/*' ' */' -c ' * ' my.c.stx w_gt my.c''

Make a literate C code document into proper C source file, leaving the
documentation in neatly-formatted comments.

  ''strip_stx -B 'cat w_lt w_lt EOT' 'EOT' embshell.stx w_gt embshell.sh''

Turn the document ''embshell.stx'' into an "embedded shell" script,
where all non-program portions are printed to the standard output when
execution reaches them.  This is akin to PHP or eperl; but ''strip_stx''
is not really meant for this.  There are other options for making
embedded scripts, such as defining your own markup for the code portions
or handling the program logic with ''m4'' within ''stx2any''.

! SEE ALSO

''stx2any'' (1)

! AUTHOR

This page is written by w_author.

