legend(5)                      DG/UX R4.11MU05                     legend(5)


NAME
       legend - debugging information technology

DESCRIPTION
       Legend debugging information (or legends for short) is used by the
       dbx(1) and mxdb(1) debuggers.  It is created during compilation
       typically by as(1) which calls the dtl(1) translator.

       Traditional UNIX compilation systems control debugging information by
       the use of a -g option.  If the -g option is present on the compiler
       command line (e.g. "cc -g") then debugging information is generated.
       Legend technology provides a number of options that can't be coded
       into a single yes or no option but many existing applications have
       makefiles and shell scripts that users don't want to modify.  The
       legend options, therefore, are controlled by an environment variable
       called LEGENDS.

OPTIONS
       The following values can be placed in the LEGENDS environment
       variable, separated by blanks, to control the generation of legends.

       -external
              Store the legend data in a separate file. If the target file
              is named "prog.o", then the legend will be stored in a file
              named "prog.lg".  This reduces the size of object files,
              libraries and executables, significantly saving link time as
              well as disk space.

       -no-external
              Store legend data in the object file.  This is the default.

       -compress
              Legends come in two forms that allow you to make a speed/space
              trade-off.  If present, this option requests that legends be
              generated in a compressed form.  You can mix compressed and
              uncompressed legends into the same application.

       -no-compress
              Don't compress the legend. This is the default.

       -keep-std
              Retain standard debugging information (pre-legend format.)  By
              default this information is deleted.

       -no-keep-std
              Don't preserve standard information.  This is the default.

       -v   Print the version of the legend translator to stderr.

       -warn  Print warning messages. They are suppressed by default.

SEE ALSO
       cc(1), dtl(1), gcc(1), as(1), mxdb(1), dbx(1)


Licensed material--property of copyright holder(s)