# (find-fline "~/mktclapp-3.9/Makefile")

cd ~/mktclapp-3.9/
pod2t --center=' ' --release='Mktclapp 3.9' --date=' ' mktclapp.pod |& l



=head1 NAME

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

=head1 SYNOPSYS

B<mktclapp>
[ B<-version> ]
[ B<-header> ]
[ B<-srcdir> I<dir> ]
[ B<-tcl-library> I<dir> ]
[ B<-tk-library> I<dir> ]
[ B<-notk> ]
[ B<-extension> I<NAME> ]
[ B<-autofork> ]
[ B<-strip-tcl> ]
[ B<-dont-strip-tcl> ]
[ B<-main-script> I<FILE> ]
[ B<-read-stdin> ]
[ B<-console> ]
[ B<-shroud> ]
[ B<-enable-obj> ]
[ B<-standalone> ]
[ B<-f> I<FILE> ]
[ I<FILE.c> ... ]
[ I<FILE.tcl> ... ]

=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

A summary of options are included below. For a complete description,
see the HTML documentation.

=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>

build a Tcl-only program.  No GUI

=item B<-extension> I<NAME>

build a Tcl/Tk extension with the given name

=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> I<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 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> I<clientData>

Always NULL for commands generated by mktclapp.

=item B<Tcl_Interp *>I<interp>

A pointer to the Tcl interpreter.

=item B<int> I<argc>

Number of arguments to the Tcl command. 1 means just the command's
name.

=item B<char **>I<argv>

Value of each argument.

=back

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) {
    ...
  }

ET_OBJARGS replaces the two last parameters of ET_TCLARGS with

=over 4

=item B<int> I<objc>

Number of arguments to the Tcl command. 1 means just the command's
name.

=item B<Tcl_Obj *>I<objv>B<[]>

Value of each argument.

=back

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(Tcl_DString *, const char *zFormat, ...);
  char *mprintf(const char *zFormat, ...);
  char *vmprintf(const char *zFormat, va_list);

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>, be sure it calls the routine
B<Et_Init(>I<argc>B<,>I<argv>B<)> at some point in order to create and
initialize the Tcl interpreter.

To run the graphical application builder, type

  xmktclapp

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.



=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