dzedit(1) [debian man page]

DZEDIT(1)						      General Commands Manual							 DZEDIT(1)

NAME

       dzedit - the CERN ZEBRA documentation editor

SYNOPSIS

       dzedit  [ options ]
       dzeX11

DESCRIPTION

       dzeX11  is  an interactive interface to the DZDOC (ZEBRA documentation) system developed at CERN.  dzedit is a wrapper script around dzeX11
       that allows one to set a few environment options.  ZEBRA, part of the Packlib library, permits a developer to create  complex  data  struc-
       tures in the FORTRAN 77 language; the DZDOC system allows the developer to generate and maintain documentation of ZEBRA data structures.

OPTIONS

       -d driver
	      Use  the	graphics driver driver, i.e., have dzedit call the program dzedriver.  The default is "X11".  You are exceedingly unlikely
	      to want anything other than the default.

       -h host
	      Give the host to open the window on.  This is the same as setting the environment variable $DISPLAY to "host:0.0".  You  don't  need
	      to do so if you are logged on to a remote host through SSH (if you are using telnet, shame on you!)

       -v version
	      Specify  the  version  of  CERNLIB to use.  This only makes sense if you have a version of CERNLIB directly from CERN installed.	In
	      this case you should also have set the environment variable $CERN.  Then dzedit will look for the dzeX11 program	in  the  directory
	      $CERN/<version>/bin/.

FILES

       dzedit.kumac
	      dzedit tries to read startup commands from this file in the current directory.

       dzedit.las
	      dzedit stores the names of the ZEBRA file and documentation file in this file in the current directory.

       last.kumac
	      At the end of a session, dzedit outputs this file containing a transcript of the commands used during the session.

SEE ALSO

       The ZEBRA manual:
       http://wwwasdoc.web.cern.ch/wwwasdoc/psdir/zebra.ps.gz
       (specifically, chapter 16 is about DZDOC).

BUGS

       This  man  page	is  essentially useless because the section of the ZEBRA manual about DZDOC is incomprehensible and there are no tutorials
       about it.  Anyone who wants to provide a better man page is welcome to do so.

AUTHOR

       This manual page was written by Kevin McCarty <kmccarty@debian.org> for the Debian GNU/Linux system (but may be used by others).

								  April 15, 2004							 DZEDIT(1)

CERNLIB(1)						      General Commands Manual							CERNLIB(1)

NAME

       cernlib - print CERN library dependencies

SYNOPSIS

       cernlib [options] libraries

DESCRIPTION

       cernlib	is  a tool to list the compiler and linker options necessary to compile a CERNLIB program that has the given library dependencies.
       It is generally used within a command substitution, as in the following example:

       gfortran -o myprogram myprogram.F `cernlib -G Motif pawlib`

       This version of cernlib has been completely rewritten from the original script provided by CERN.  It now does recursive library	dependency
       checking and removes duplicate entries.

       Note  that by default, the cernlib script assumes that the CERN libraries are to be linked against statically; if the environment variables
       $CERN or $CERN_ROOT are specified, it looks for the libraries only in the "lib" subdirectory of those locations, not any "shlib"  subdirec-
       tory.  Furthermore, the script brackets the CERN libraries with linker instructions to link statically.	This is done to preserve the orig-
       inal upstream behavior, in which all CERNLIB libraries exist only in static form.  For instance, "cernlib packlib" outputs:

       -Wl,-static -lpacklib -lkernlib -Wl,-dy -lm -lnsl -lcrypt -ldl -lg2c

       If you want to link against ALL libraries (including CERNLIB) either statically or dynamically, call the cernlib script with its -safe flag
       to  omit  these bracketing linker flags.  That is: if you want to link against all libraries (not just CERNLIB) statically, use the -static
       compiler flag and call cernlib with its -safe flag:

       gfortran -o myprogram myprogram.F -static `cernlib -safe -G Motif pawlib`

       and if you want to link against all libraries (including the CERN libraries) dynamically, use the same command without the -static compiler
       flag (the linker assumes dynamic linking by default):

       gfortran -o myprogram myprogram.F `cernlib -safe -G Motif pawlib`

OPTIONS

       -a arch
	      Specify a system architecture, e.g. Linux (default), AIX, HP-UX, etc.

       -dy    Equivalent to -safe; for backwards compatibility.

       -G driver
	      Specify  a  graphics  driver.   The  available options on Linux are X11 and Motif (the latter option will also work when the Lesstif
	      library is present).

       -P, -s Ignored; for backwards compatibility.

       -safe  Do not make any assumptions about whether the CERN libraries should be linked  against  dynamically  or  statically.   (The  default
	      behavior, if this flag is not used, is to link them statically.)

       -u     Do not include architecture-specific libraries in the output.

       -v version
	      Specify  version of $CERN_LEVEL.	This is meaningless unless you have installed an upstream version of CERNLIB (i.e. not packaged by
	      Debian); see the file /usr/share/doc/cernlib-base/README.Debian.

       -?, --help
	      Show a summary of options.

       --     Tell cernlib that this marks the end of cernlib-specific flags, and all following arguments are to be parsed  as	described  in  the
	      LIBRARIES  section  below.   If  -- is not given, the first word parsed as a library name will be the first word not starting with a
	      hyphen "-" that is not an argument to a preceding cernlib flag.

LIBRARIES

       The following library names are recognized by this version of the cernlib script.  These names may be used exactly as shown here,  or  pre-
       fixed by "-l".

       Core CERN libraries
	      mathlib, packlib, kernlib

       Graphics and PAW libraries
	      graflib, pawlib

       Monte Carlo and GEANT libraries
	      cojets, eurodec, geant321, herwig59, isajet758, pdflib804, photos202, phtools

       Additional Monte Carlo libraries
	      (to obtain these, see /usr/share/doc/montecarlo-base/README.Debian)
	      ariadne, ariadne-p5, fritiof, jetset, lepto, pythia5, pythia6

       Aliases
	      The numerals at the end may be left off most of the library names above.

       Other library names
	      Various  other  names are recognized for backwards compatibility, internal use, and non-Linux architectures.  For the complete list,
	      please see the cernlib script.

       Other  Any names not recognized by cernlib that start with "-l" or with any character other than a hyphen ("-") are output as  -l${name#-l}
	      (i.e.,  are assumed to be a library).  Names starting with a hyphen for which the second character is not "l" are assumed to be com-
	      piler flags, and are output at the beginning of the line before all other output.

SEE ALSO

       /usr/share/doc/cernlib-base/README.Debian describes some of the changes that have been made to the CERN libraries in order to  comply  with
       Debian policy and the Filesystem Hierarchy Standard.

       CERNLIB documentation for all related libraries and programs is available at the following URL: http://cern.ch/cernlib/

AUTHOR

       This manual page and the version of the cernlib script that it describes were written by Kevin McCarty <kmccarty@debian.org> for the Debian
       GNU/Linux system (but may be used by others).  They are licensed under the GNU General Public License, version 2 or later (at your choice).

COPYRIGHT

       Copyright (C) Kevin B. McCarty, 2002, 2003, 2004, 2005, 2006.

								    Jan 6, 2005 							CERNLIB(1)