[6493] in Athena Bugs

home help back first fref pref prev next nref lref last post

vax 7.1H: Scribe Thesis

daemon@ATHENA.MIT.EDU (daemon@ATHENA.MIT.EDU)
Thu Nov 29 19:38:06 1990

From: drmorris@ATHENA.MIT.EDU
To: bugs@ATHENA.MIT.EDU
Date: Thu, 29 Nov 90 19:37:45 EST

System name:		heath-bar-crunch
Type and version:	CVAXSTAR 7.1H (1 update(s) to same version)
Display type:		SM

I don't know where I should be reporting this, but since I've reported
it here in the past...

What were you trying to do?
	Make a scribe thesis.

What's wrong:
	The thesis.mss uses @Include for the table of contents.  This
requires a Makefile hack to rename the contents files between runs.

	Mitthe.mak uses the @Enable command.  (Try to find documentation
on this command!)

What should have happened:
	The thesis.mss should use @BackPlace, so that the renaming is
not needed.  The Makefile is now obsolete, so it should be deleted (or
at minimum, the -mv lines deleted).

	Mitthe.mak should use the @Generate command.

Please describe any relevant documentation references:
	Scribe manuals (all).

	Working new source is in /mit/scribedev/src/thesis.  The file
'diffs' is a list of relavent context diffs, included below.

*** /mit/thesis/scribe/README	Wed Nov 15 10:33:40 1989
--- ./README	Thu Nov 29 19:26:00 1990
***************
*** 17,32 ****
  
  	README		- this file.
  
- 	Makefile	- makes it easier to scribe the thesis.  Note
- 				that because of the way Scribe generates 
- 				the table of contents you must rename the
- 				contents files in between Scribe runs.  Type
- 
- 						make thesis
- 
- 				to have it handle all of the renaming of
- 				files and stuff for you.
- 
  	thesis.mss	- main file used in scribing.  Do not put any
  				text of your thesis here, only @include
  				statements.
--- 17,22 ----
***************
*** 83,91 ****
  'make thesis' while you in this directory.  You may run Scribe on any
  separate section of the thesis provided you include the appropriate
  "@Part" commands at the beginning of the section's ".mss" file.
- 
- Remember to rename the include file in between each Scribe run.  (The
- makefile does this automatically.)
  
  You might want to consider learning RCS (the Revision Control System) or
  finding a way to make sure that you always have a backup copy.
--- 73,78 ----
*** /mit/thesis/scribe/thesis.mss	Wed Nov 15 10:33:46 1989
--- ./thesis.mss	Thu Nov 29 19:13:58 1990
***************
*** 4,24 ****
  Machine.  It is currently set up to use a PostScript printer.
  
  The include of dedication.mss is optional, you may delete it if you are not
! including a dedication.  Scribe generates thesis.con, thesis.fig and
! thesis.tab.  In between each pass through Scribe (your final version will
! probably require 3 runs through Scribe to get all of the references correct)
! you must rename these three files to have a .include ending so that they don't
! get smashed before they are included.  Otherwise your thesis won't have any
! tables of contents, etc.  The three files are:
  
- 	thesis.con		table of contents
- 	thesis.fig		table of figures
- 	thesis.tab		table of tables
- 
- If you do not have any tables or figures you may eliminate the appropriate
- include lines from below.  If you do remove one of the include lines you should
- also remove the corresponding line from the Makefile.
- 
  *************************************************************************}
  
  @comment{Global @style, @define, @etc. stuff for top of document.}
--- 4,11 ----
  Machine.  It is currently set up to use a PostScript printer.
  
  The include of dedication.mss is optional, you may delete it if you are not
! including a dedication.
  
  *************************************************************************}
  
  @comment{Global @style, @define, @etc. stuff for top of document.}
***************
*** 34,50 ****
  @include[frontpage.mss]
  @include[dedication.mss]
  
! @comment{Delete any lines that you don't use.  Make sure that you do
  
! 			mv thesis.con thesis.con.include
! 			mv thesis.fig thesis.fig.include
! 			mv thesis.tab thesis.tab.include
! 
! 	in between each Scribe run (i.e. use the makefile).}
! 
! @include[thesis.con.include]
! @include[thesis.fig.include]
! @include[thesis.tab.include]
  
  
  @comment{Here are the chapters...}
--- 21,32 ----
  @include[frontpage.mss]
  @include[dedication.mss]
  
! @comment{Include the contents pages.  You can leave all of these in,
! Scribe won't include the ones you don't have.}
  
! @backplace[Contents]
! @backplace[FigureContents]
! @backplace[TableContents]
  
  
  @comment{Here are the chapters...}
*** /mit/thesis/scribe/mitthe.mak	Wed Nov 15 10:33:45 1989
--- ./mitthe.mak	Thu Nov 29 19:17:30 1990
***************
*** 14,20 ****
         WidowAction Force,References=STDnumeric,
  	TopMargin 1.33inch,BottomMargin 1.inch)
  @Modify(HDG,Fixed 1.0inch)
! @Enable(Contents="con")
  @Send(Contents "@Style(PageNumber <@1>)")
  @Send(Contents "@UnNumbered(Table of Contents)")
  
--- 14,20 ----
         WidowAction Force,References=STDnumeric,
  	TopMargin 1.33inch,BottomMargin 1.inch)
  @Modify(HDG,Fixed 1.0inch)
! @Generate(Contents="con")
  @Send(Contents "@Style(PageNumber <@1>)")
  @Send(Contents "@UnNumbered(Table of Contents)")
  
***************
*** 92,98 ****
         WidowAction Force,References=STDnumeric,
  	TopMargin 1.33inch,BottomMargin 1.inch)
  @Modify(HDG,Fixed 1.0inch)
! @Enable(Contents="con")
  @Send(Contents "@Style(PageNumber <@1>)")
  @Send(Contents "@UnNumbered(Table of Contents)")
  
--- 92,98 ----
         WidowAction Force,References=STDnumeric,
  	TopMargin 1.33inch,BottomMargin 1.inch)
  @Modify(HDG,Fixed 1.0inch)
! @Generate(Contents="con")
  @Send(Contents "@Style(PageNumber <@1>)")
  @Send(Contents "@UnNumbered(Table of Contents)")
  
***************
*** 170,176 ****
  @Modify(HDG,Fixed 1.0inch)
  @Typewheel(Elite 12)
  
! @Enable(Contents="con")
  @Send(Contents "@Style(PageNumber <@1>)")
  @Send(Contents "@UnNumbered(Table of Contents)")
  
--- 170,176 ----
  @Modify(HDG,Fixed 1.0inch)
  @Typewheel(Elite 12)
  
! @Generate(Contents="con")
  @Send(Contents "@Style(PageNumber <@1>)")
  @Send(Contents "@UnNumbered(Table of Contents)")
  
***************
*** 246,252 ****
  	TopMargin 1.33inch,BottomMargin 1.inch)
  @Modify(HDG,Fixed 1.0inch)
  @Modify(Description,Spread .167inch)
! @Enable(Outline,Contents="con")
  @Send(Contents "@Style(PageNumber <@1>)")
  @Send(Contents "@UnNumbered(Table of Contents)")
  
--- 246,252 ----
  	TopMargin 1.33inch,BottomMargin 1.inch)
  @Modify(HDG,Fixed 1.0inch)
  @Modify(Description,Spread .167inch)
! @Generate(Outline,Contents="con")
  @Send(Contents "@Style(PageNumber <@1>)")
  @Send(Contents "@UnNumbered(Table of Contents)")
  
***************
*** 319,324 ****
--- 319,325 ----
  24 AUG 1982	DEO	Created first refined MIT thesis environment
  ]
  @Comment[
+ 29 NOV 1990	DRM	Enable changed to Generate
  27 FEB 1985	JLF	Took out JCF things and Immediate in pageheading
  18 APR 1984	ADF	Fixed the CopyRight notice in the general marker
  in the form library mitfor.lib
*** /mit/thesis/scribe/mitfig.lib	Wed Jun 27 11:07:48 1990
--- ./mitfig.lib	Thu Nov 29 16:39:47 1990
***************
*** 8,13 ****
--- 8,14 ----
  			using secondary labels in BeforeExit
  01 JAN 1982	DEO	modified from Scribe Figure.lib
  }
+ @Generate(FigureContents="fig",TableContents="tab")
  @Enable(FigureContents="fig",TableContents="tab")
  @Send(FigureContents "@Style(PageNumber <@1>)")
  @Send(FigureContents "@UnNumbered(List of Figures)")



home help back first fref pref prev next nref lref last post