From 2ba8875a0b268d572ef2a27584d3f845ec1391b0 Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Wed, 26 Apr 2000 18:02:26 +0000 Subject: Patch rtemsdoc-4.5.0-rc-0.diff from Ralf Corsepius which contains the bulk of converting the documentation tree to automake and GNU conventions. Comments follow: This is the automake port of rtemsdoc. To apply: cvs co rtemsdoc cd rtemsdoc sh cvs-rm.sh patch -p0 < rtemsdoc-4.5.0-rc-0.diff sh cvs-add.sh [Attention: cvs-rm.sh and cvs-add.sh directly modify cvs] Known bugs: 1) src2html is not supported (yet? - Is this supposed to work?) 2) all *.pdf images now are generated on-the-fly, but not yet deleted during "make distclean" 3) All supplements, including the templated ones, get build and installed. 4) Building outside of the source tree is completely untested and very likely does not work. 5) Make [ps|pdf] are not (yet) supported, make [dvi|info] are supported by automake's default texinfo rules. Fixing 2, 3 and 5 is almost trivial and needs to be done. 4) is a matter of testing and tool-properties, for now it is simply untested. General issues: * gif vs jpg vs png. I would recommend to replace all images with pngs to avoid potential copyright issues (gif) or lack in quality (jpg, jpg is good for real world photographs, but extremely poor on artificial images, graphs). * pdf images do net get placed correctly in pdf-documents. * texinfo: We now use a local copy of texinfo-4.0's texinfo.tex in texinfo/texinfo.tex for generating infos. However pdftex's system-wide texinfo.tex and pdftexinfo.tex are used for generating *.dvi, *.ps, *.pdf. * .cvsignore files still missing. * I have renamed the supplements filename not to use c_, because automake seems to have problems with it. Notes: * Again, I recommend not to put any generated files into CVS. Here, this comprises some *texi, all *.pdf and many *.html pages. Ie. I recommend to run make maintainer-clean before checking in any files. * To get building started, this should be sufficient: ./bootstrap ./configure cd tools; make; cd .. make info * To make a public tarball: [cvs co ; ./bootstrap] ./configure cd tools; make; cd .. make info [make clean] make dist => This generates a rtems-.tar.gz in the toplevel directory. => Building the tools only is required after a "cvs co", but not in a distribution tarball. --- doc/user/Makefile | 194 -------------------------------------------------- doc/user/Makefile.am | 157 ++++++++++++++++++++++++++++++++++++++++ doc/user/rtemspie.pdf | Bin 5715766 -> 0 bytes doc/user/states.pdf | Bin 488333 -> 0 bytes 4 files changed, 157 insertions(+), 194 deletions(-) delete mode 100644 doc/user/Makefile create mode 100644 doc/user/Makefile.am delete mode 100644 doc/user/rtemspie.pdf delete mode 100644 doc/user/states.pdf (limited to 'doc/user') diff --git a/doc/user/Makefile b/doc/user/Makefile deleted file mode 100644 index 1e4cc53234..0000000000 --- a/doc/user/Makefile +++ /dev/null @@ -1,194 +0,0 @@ -# -# COPYRIGHT (c) 1988-1999. -# On-Line Applications Research Corporation (OAR). -# All rights reserved. -# -# $Id$ -# - -PROJECT=c_user - -include ../Make.config - -all: html info ps pdf - -dirs: - $(make-dirs) - -COMMON_FILES=../common/cpright.texi -FILES= bsp.texi c_user.texi clock.texi concepts.texi conf.texi \ - dirstat.texi dpmem.texi event.texi example.texi fatal.texi \ - glossary.texi init.texi intr.texi io.texi mp.texi msg.texi overview.texi \ - part.texi preface.texi region.texi rtmon.texi schedule.texi sem.texi \ - signal.texi task.texi timer.texi userext.texi $(COMMON_FILES) - -GENERATED_FILES=overview.texi concepts.texi init.texi task.texi \ - intr.texi clock.texi timer.texi sem.texi msg.texi \ - event.texi signal.texi part.texi region.texi \ - dpmem.texi io.texi fatal.texi schedule.texi rtmon.texi \ - bsp.texi userext.texi conf.texi mp.texi - -INFOFILES=$(wildcard $(PROJECT) $(PROJECT)-*) - -info: dirs $(PROJECT) - cp $(PROJECT) $(PROJECT)-* $(INFO_INSTALL) - -$(PROJECT): $(FILES) - $(MAKEINFO) $(PROJECT).texi - -dvi: dirs $(PROJECT).dvi -ps: dirs $(PROJECT).ps -pdf: dirs $(PROJECT).pdf - -$(PROJECT).pdf: $(FILES) - $(TEXI2PDF) $(PROJECT).texi - cp $(PROJECT).pdf $(WWW_INSTALL)/$(PROJECT) - -$(PROJECT).ps: $(PROJECT).dvi - dvips -o $(PROJECT).ps $(PROJECT).dvi - cp $(PROJECT).ps $(WWW_INSTALL)/$(PROJECT) - -$(PROJECT).dvi: $(FILES) - $(TEXI2DVI) $(PROJECT).texi - cp $(PROJECT).dvi $(WWW_INSTALL)/$(PROJECT) - -html: dirs $(FILES) - -mkdir -p $(WWW_INSTALL)/$(PROJECT) - cp rtemsarc.png rtemspie.png states.png $(WWW_INSTALL)/c_user - $(TEXI2WWW) $(TEXI2WWW_ARGS) -dir $(WWW_INSTALL)/$(PROJECT) \ - $(PROJECT).texi - -index: - texindex $(PROJECT).cp $(PROJECT).vr $(PROJECT).fn \ - $(PROJECT).tp $(PROJECT).pg $(PROJECT).ky - -clean: - rm -f *.o $(PROG) *.txt core *.html $(PROJECT).pdf - rm -f *.dvi *.ps *.log *.aux *.cp *.fn *.ky *.pg *.toc *.tp *.vr $(BASE) - rm -f $(PROJECT) $(PROJECT)-* _* $(GENERATED_FILES) - rm -f *.cps *.cpss *.fns *.kys *.pgs *.tps *.vrs - - -#preface.texi: preface.t -# $(BMENU) -p "Top" \ -# -u "Top" \ -# -n "Overview" ${*}.t - -overview.texi: overview.t - $(BMENU) -p "Preface" \ - -u "Top" \ - -n "Key Concepts" ${*}.t - -concepts.texi: concepts.t - $(BMENU) -p "Overview Manual Organization" \ - -u "Top" \ - -n "Initialization Manager" ${*}.t - -init.texi: init.t - $(BMENU) -p "Key Concepts Memory Management" \ - -u "Top" \ - -n "Task Manager" ${*}.t - -task.texi: task.t - $(BMENU) -p "Initialization Manager SHUTDOWN_EXECUTIVE - Shutdown RTEMS" \ - -u "Top" \ - -n "Interrupt Manager" ${*}.t - -intr.texi: intr.t - $(BMENU) -p "Task Manager TASK_VARIABLE_DELETE - Remove per task variable" \ - -u "Top" \ - -n "Clock Manager" ${*}.t - -clock.texi: clock.t - $(BMENU) \ - -p "Interrupt Manager INTERRUPT_IS_IN_PROGRESS - Is an ISR in Progress" \ - -u "Top" \ - -n "Timer Manager" ${*}.t - -timer.texi: timer.t - $(BMENU) -p "Clock Manager CLOCK_TICK - Announce a clock tick" \ - -u "Top" \ - -n "Semaphore Manager" ${*}.t - -sem.texi: sem.t - $(BMENU) -p "Timer Manager TIMER_RESET - Reset an interval timer" \ - -u "Top" \ - -n "Message Manager" ${*}.t - -msg.texi: msg.t - $(BMENU) -p "Semaphore Manager SEMAPHORE_FLUSH - Unblock all tasks waiting on a semaphore" \ - -u "Top" \ - -n "Event Manager" ${*}.t - -event.texi: event.t - $(BMENU) \ - -p "Message Manager MESSAGE_QUEUE_FLUSH - Flush all messages on a queue" \ - -u "Top" \ - -n "Signal Manager" ${*}.t - -signal.texi: signal.t - $(BMENU) -p "Event Manager EVENT_RECEIVE - Receive event condition" \ - -u "Top" \ - -n "Partition Manager" ${*}.t - -part.texi: part.t - $(BMENU) -p "Signal Manager SIGNAL_SEND - Send signal set to a task" \ - -u "Top" \ - -n "Region Manager" ${*}.t - -region.texi: region.t - $(BMENU) \ --p "Partition Manager PARTITION_RETURN_BUFFER - Return buffer to a partition" \ - -u "Top" \ - -n "Dual-Ported Memory Manager" ${*}.t - -dpmem.texi: dpmem.t - $(BMENU) \ - -p "Region Manager REGION_GET_SEGMENT_SIZE - Obtain size of a segment" \ - -u "Top" \ - -n "I/O Manager" ${*}.t - -io.texi: io.t - $(BMENU) -p "Dual-Ported Memory Manager PORT_INTERNAL_TO_EXTERNAL - Convert internal to external address" \ - -u "Top" \ - -n "Fatal Error Manager" ${*}.t - -fatal.texi: fatal.t - $(BMENU) -p "I/O Manager IO_CONTROL - Special device services" \ - -u "Top" \ - -n "Scheduling Concepts" ${*}.t - -schedule.texi: schedule.t - $(BMENU) \ --p "Fatal Error Manager FATAL_ERROR_OCCURRED - Invoke the fatal error handler" \ - -u "Top" \ - -n "Rate Monotonic Manager" ${*}.t - -rtmon.texi: rtmon.t - $(BMENU) -p "Scheduling Concepts Task State Transitions" \ - -u "Top" \ - -n "Board Support Packages" ${*}.t - -bsp.texi: bsp.t - $(BMENU) -p "Rate Monotonic Manager RATE_MONOTONIC_GET_STATUS - Obtain status information on period" \ - -u "Top" \ - -n "User Extensions Manager" ${*}.t - -userext.texi: userext.t - $(BMENU) -p "Board Support Packages Heterogeneous Systems" \ - -u "Top" \ - -n "Configuring a System" ${*}.t - -conf.texi: conf.t - $(BMENU) -p "User Extensions Manager EXTENSION_DELETE - Delete a extension set" \ - -u "Top" \ - -n "Multiprocessing Manager" ${*}.t - -mp.texi: mp.t - $(BMENU) -p "Configuring a System Sizing the RTEMS RAM Workspace" \ - -u "Top" \ - -n "Directive Status Codes" ${*}.t - -convert: - /usr/bin/gs -dMaxBitmap=300000000 -g5500x5500 -sDEVICE=pdfwrite -q -dNOPAUSE -dSAFER -sOutputFile=rtemspie.pdf -- rtemspie.eps -c -quit - /usr/bin/gs -dMaxBitmap=300000000 -g5500x5500 -sDEVICE=pdfwrite -q -dNOPAUSE -dSAFER -sOutputFile=states.pdf -- states.eps -c -quit diff --git a/doc/user/Makefile.am b/doc/user/Makefile.am new file mode 100644 index 0000000000..fc81acf71c --- /dev/null +++ b/doc/user/Makefile.am @@ -0,0 +1,157 @@ +# +# COPYRIGHT (c) 1988-1999. +# On-Line Applications Research Corporation (OAR). +# All rights reserved. +# +# $Id$ +# + +AUTOMAKE_OPTIONS = foreign + +PROJECT=c_user + +include $(top_srcdir)/project.am + +COMMON_FILES=$(top_srcdir)/common/cpright.texi + +FILES= bsp.texi dirstat.texi example.texi glossary.texi preface.texi + +GENERATED_FILES=overview.texi concepts.texi init.texi task.texi \ + intr.texi clock.texi timer.texi sem.texi msg.texi \ + event.texi signal.texi part.texi region.texi \ + dpmem.texi io.texi fatal.texi schedule.texi rtmon.texi \ + bsp.texi userext.texi conf.texi mp.texi + +info_TEXINFOS = c_user.texi +c_user_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES) + +PNG_FILES = rtemsarc.png rtemspie.png states.png +if USE_HTML +html_project_DATA += $(PNG_FILES) +endif + +#preface.texi: preface.t +# $(BMENU) -p "Top" \ +# -u "Top" \ +# -n "Overview" $< + +overview.texi: overview.t + $(BMENU) -p "Preface" \ + -u "Top" \ + -n "Key Concepts" $< + +concepts.texi: concepts.t + $(BMENU) -p "Overview Manual Organization" \ + -u "Top" \ + -n "Initialization Manager" $< + +init.texi: init.t + $(BMENU) -p "Key Concepts Memory Management" \ + -u "Top" \ + -n "Task Manager" $< + +task.texi: task.t + $(BMENU) -p "Initialization Manager SHUTDOWN_EXECUTIVE - Shutdown RTEMS" \ + -u "Top" \ + -n "Interrupt Manager" $< + +intr.texi: intr.t + $(BMENU) -p "Task Manager TASK_VARIABLE_DELETE - Remove per task variable" \ + -u "Top" \ + -n "Clock Manager" $< + +clock.texi: clock.t + $(BMENU) \ + -p "Interrupt Manager INTERRUPT_IS_IN_PROGRESS - Is an ISR in Progress" \ + -u "Top" \ + -n "Timer Manager" $< + +timer.texi: timer.t + $(BMENU) -p "Clock Manager CLOCK_TICK - Announce a clock tick" \ + -u "Top" \ + -n "Semaphore Manager" $< + +sem.texi: sem.t + $(BMENU) -p "Timer Manager TIMER_RESET - Reset an interval timer" \ + -u "Top" \ + -n "Message Manager" $< + +msg.texi: msg.t + $(BMENU) -p "Semaphore Manager SEMAPHORE_FLUSH - Unblock all tasks waiting on a semaphore" \ + -u "Top" \ + -n "Event Manager" $< + +event.texi: event.t + $(BMENU) \ + -p "Message Manager MESSAGE_QUEUE_FLUSH - Flush all messages on a queue" \ + -u "Top" \ + -n "Signal Manager" $< + +signal.texi: signal.t + $(BMENU) -p "Event Manager EVENT_RECEIVE - Receive event condition" \ + -u "Top" \ + -n "Partition Manager" $< + +part.texi: part.t + $(BMENU) -p "Signal Manager SIGNAL_SEND - Send signal set to a task" \ + -u "Top" \ + -n "Region Manager" $< + +region.texi: region.t + $(BMENU) \ +-p "Partition Manager PARTITION_RETURN_BUFFER - Return buffer to a partition" \ + -u "Top" \ + -n "Dual-Ported Memory Manager" $< + +dpmem.texi: dpmem.t + $(BMENU) \ + -p "Region Manager REGION_GET_SEGMENT_SIZE - Obtain size of a segment" \ + -u "Top" \ + -n "I/O Manager" $< + +io.texi: io.t + $(BMENU) -p "Dual-Ported Memory Manager PORT_INTERNAL_TO_EXTERNAL - Convert internal to external address" \ + -u "Top" \ + -n "Fatal Error Manager" $< + +fatal.texi: fatal.t + $(BMENU) -p "I/O Manager IO_CONTROL - Special device services" \ + -u "Top" \ + -n "Scheduling Concepts" $< + +schedule.texi: schedule.t + $(BMENU) \ +-p "Fatal Error Manager FATAL_ERROR_OCCURRED - Invoke the fatal error handler" \ + -u "Top" \ + -n "Rate Monotonic Manager" $< + +rtmon.texi: rtmon.t + $(BMENU) -p "Scheduling Concepts Task State Transitions" \ + -u "Top" \ + -n "Board Support Packages" $< + +bsp.texi: bsp.t + $(BMENU) -p "Rate Monotonic Manager RATE_MONOTONIC_GET_STATUS - Obtain status information on period" \ + -u "Top" \ + -n "User Extensions Manager" $< + +userext.texi: userext.t + $(BMENU) -p "Board Support Packages Heterogeneous Systems" \ + -u "Top" \ + -n "Configuring a System" $< + +conf.texi: conf.t + $(BMENU) -p "User Extensions Manager EXTENSION_DELETE - Delete a extension set" \ + -u "Top" \ + -n "Multiprocessing Manager" $< + +mp.texi: mp.t + $(BMENU) -p "Configuring a System Sizing the RTEMS RAM Workspace" \ + -u "Top" \ + -n "Directive Status Codes" $< + +noinst_DATA = \ +states.gif states.eps \ +rtemspie.gif rtemspie.eps + +EXTRA_DIST = *.t $(PNG_FILES) $(noinst_DATA) diff --git a/doc/user/rtemspie.pdf b/doc/user/rtemspie.pdf deleted file mode 100644 index ad64183eed..0000000000 Binary files a/doc/user/rtemspie.pdf and /dev/null differ diff --git a/doc/user/states.pdf b/doc/user/states.pdf deleted file mode 100644 index 490d2e00cd..0000000000 Binary files a/doc/user/states.pdf and /dev/null differ -- cgit v1.2.3