html/man_butchur.1.html

   1 <!-- manual page source format generated by PolyglotMan v3.0.7, -->
   2 <!-- available via anonymous ftp from ftp.cs.berkeley.edu:/ucb/people/phelps/tcltk/rman.tar.Z -->
   3
   4 <HTML>
   5 <HEAD>
   6 <TITLE>Man page for butchur.1</TITLE>
   7 </HEAD>
   8 <BODY bgcolor=white>
   9 <A HREF="#toc">Table of Contents</A><P>
  10
  11 <H2><A NAME="sect0" HREF="#toc0">Name</A></H2>
  12
  13 <P>
  14 butchur - cut some procedures out of a SUIF file
  15
  16 <H2><A NAME="sect1" HREF="#toc1"><B>Synopsis</B></A></H2>
  17
  18 <P>
  19 <B>butchur</B> [ <I>options</I> ] <B>-only</B> <I>procname</I> { , <I>procname</I> }* <I>infile</I>
  20 <I>outfile</I>
  21 <P>
  22 <B>butchur</B> [ <I>options</I> ] <B>-all-but</B> <I>procname</I> { , <I>procname</I> }*
  23 <I>infile</I> <I>outfile</I>
  24
  25 <H2><A NAME="sect2" HREF="#toc2"><B>Description</B></A></H2>
  26
  27 <P>
  28 The <I>butchur</I> program cuts selected procedure and variable
  29 definitions out of a SUIF file. With the <B>-only</B> option,
  30 butcher includes only the specified definitions in the
  31 output file. With the <B>-all-but</B> option, butcher includes
  32 all except the specified definitions.
  33 <P>
  34 Note that it is legal to split definitions into different
  35 files by running <I>butchur</I> multiple times, then eventually
  36 link the definitions back together and run the program.
  37 <I>butchur</I> makes sure the semantics are unchanged. Anything
  38 in the file symbol table that would have to be shared is
  39 automatically moved into the interfile global symbol
  40 table.
  41
  42 <H2><A NAME="sect3" HREF="#toc3"><B>Options</B></A></H2>
  43
  44 <P>
  45 <B>-keep-unused</B><BR>
  46
  47 This option causes all file and interfile global
  48 symbol table object to be retained, regardless of
  49 whether they are still referenced. The default is
  50 to retain only those symbol table objects that are
  51 needed by procedures that are written out or annotations
  52 on global symbols tables or the file set
  53 entry.
  54
  55 <H2><A NAME="sect4" HREF="#toc4"><B>History</B></A></H2>
  56
  57 <P>
  58 This program was written by Chris Wilson.
  59 <P>
  60
  61 <HR><P>
  62 <A NAME="toc"><B>Table of Contents</B></A><P>
  63 <UL>
  64 <LI><A NAME="toc0" HREF="#sect0">Name</A></LI>
  65 <LI><A NAME="toc1" HREF="#sect1">Synopsis</A></LI>
  66 <LI><A NAME="toc2" HREF="#sect2">Description</A></LI>
  67 <LI><A NAME="toc3" HREF="#sect3">Options</A></LI>
  68 <LI><A NAME="toc4" HREF="#sect4">History</A></LI>
  69 </UL>
  70 </BODY></HTML>