# (find-pl5file "pod/perlpod.pod")
# (find-pl5file "pod/perlpod.pod" "item, over")
# (find-pl5file "pod/perl.pod" "usability")
# (find-fline "/usr/bin/pod2man")
# (find-fline "/usr/bin/pod2man" "item, over")
# (find-fline "/usr/bin/pod2man" "DEF_CENTER")
# (find-es "debiandev" "writing_pods")
# (find-mimelitefile "")
# (find-mimelitefile "lib/MIME/Lite.pm")

# B<mktclapp> is a program that parses a series of C and Tcl files and
# outputs a C file that will play the role of an extended tclsh or
# wish.


=head1 NAME

mktclapp - a tool for building C/C++ programs that use Tcl/Tk

=head1 SYNOPSYS

B<pod2man>
[ B<--section=>I<manext> ]
[ B<--release=>I<relpatch> ]
[ B<--center=>I<string> ]
[ B<--date=>I<string> ]
[ B<--fixed=>I<font> ]
[ B<--official> ]
[ B<--lax> ]
I<inputfile>

=head1 DESCRIPTION

This manual page documents briefly the B<mktclapp> command. This
manual page was written for the Debian GNU/Linux distribution because
the original program does not have a manual page. Instead, it has
documentation in HTML placed in /usr/doc/mktclapp and examples in
/usr/doc/mktclapp/examples.


=head1 OPTIONS

The program follow the usual GNU command line syntax, with long
options starting with two dashes (`-').
A summary of options are included below.
For a complete description, see the Info files.

=over 4

=item B<-version>

print the version number of mktclapp and exit

=item B<-header>

print a header file and exit

=item B<-srcdir> I<dir>

Prepend I<dir> to all relative pathnames

=item B<-tcl-library> I<dir>

directory holding the TCL script library

=item B<-tk-library> I<dir>

directory holding the TK script library

=item B<-notk>

built a Tcl-only program.  No GUI

=item B<-autofork>

automatically fork the program into the background

=item B<-strip-tcl>

remove comments and extra white-space from subsequent TCL files

=item B<-dont-strip-tcl>

stop stripping TCL files

=item B<-main-script> I<FILE>

run the script FILE after initialization

=item B<-read-stdin>

read standard input

=item B<-console>

create a console window

=item B<-shroud>

hide compile-in TCL from view

=item B<-enable-obj>

use TCL Obj commands where possible

=item B<-standalone>

make the "source" TCL command only work for builtin scripts

=item B<-f FILE>

read more command-line parameters from FILE

=item I<FILE.c>

scan this file for new TCL commands

=item I<FILE.tcl>

compile this file into the generated C code

=back


=head1 WEB SITE

http://www.hwaci.com/sw/mktclapp/

=head1 AUTHORS

Mktclapp was written by D. Richard Hipp <drh@acm.org>; this manual page was
written by Eduardo Ochs <edrx@mat.puc-rio.br>, for the Debian
GNU/Linux system (but may be used by others).

=cut




=head1 QUICK REFERENCE

To create a new Tcl command named B<abcdef> in C code, do this:

  int ET_COMMAND_abcdef(ET_TCLARGS){
    ...
  }

The B<ET_TCLARGS> macro declares four parameters:

=over 4

=item B<clientData>

Always NULL for commands generated by mktclapp.

=item B<interp>

A pointer to the Tcl interpreter.

=item B<argc>

Number of arguments to the Tcl command.

=item B<argv>

Value of each argument.

=cut


The C implementation of Tcl commands must return one of the following
integer values: B<TCL_OK>, B<TCL_ERROR>, B<TCL_CONTINUE>, B<TCL_BREAK>
or B<TCL_RETURN>.

To create a new Obj_Tcl command named B<ghijkl> in C code, do this:

  int ET_OBJCOMMAND_ghijkl(ET_OBJARGS){
    ...
  }

The following extra C functions are available:

  int Et_EvalF(Tcl_Interp * interp, const char * zFormat, ...);
  int Et_GlobalEvalF(Tcl_Interp *interp, const char *zFormat, ...);
  int Et_ResultF(Tcl_Interp *interp, const char *zFormat, ...);
  int Et_DStringAppendF</b>(Tcl_DString *, const char *zFormat, ...);
  char *mprintf(const char *zFormat, ...);
  char *vmprintf(const char *zFormat, va_list);

=head2 Global C variables:

  Tcl_Interp *Et_Interp;

Global Tcl variables:

  Et_EvalTrace

Mktclapp will create suitable implementations of the following functions
if you fail to do so yourself:

  int main(int argc, char **argv);

  int Et_PreInit(Tcl_Interp *interp);

  int Et_AppInit(Tcl_Interp *interp);

If you make your own B<main>, but sure it calls the routine
B<Et_Init>(argc,argv) at some point in order to create and initialize
the Tcl interpreter.

To run the graphical application builder, type

  wish xmktclapp.tcl

To run from the command line (or from within a Makefile) enter
B<mktclapp> I<options...>.  For information on 
available options, type "B<mktclapp -help>".

See complete documentation on mktclapp at
http://www.hwaci.com/sw/mktclapp/mktclapp.html.


=cut