[6493] in Athena Bugs
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)")