330 lines
10 KiB
Makefile
330 lines
10 KiB
Makefile
#!smake -r
|
|
# Makefile for making a book
|
|
#
|
|
# Building books and figures:
|
|
# To build the print figures for the book issue the command 'make print',
|
|
# this must be done in order to populate the print directory with your
|
|
# figures - your files must reference the figures from the print
|
|
# directory not the orig directory.
|
|
# To build the book issue the command 'make book'.
|
|
#
|
|
# Cleaning up files:
|
|
# To remove the master sgml file and books directory use 'make clean_book'.
|
|
# To remove the *.sgm files issue 'make clean_sgm'.
|
|
# To clean up all the figures use 'make clean_figures'.
|
|
# Do this only if you really want to clean up your figures directories and
|
|
# you haven't done any figure conversions by hand.
|
|
# To clean up everything issue 'make clobber' - this includes the figures.
|
|
|
|
# Edit this file in the locations specified.
|
|
|
|
# Location 1: The TITLE, FULL_TITLE, and VERSION Variables
|
|
#
|
|
# TITLE defines the short title of the book. Please verify the
|
|
# short title with your production editor.
|
|
#
|
|
# This title must be a valid directory name and not contain any special
|
|
# characters or a leading '.' Do not have a trailing space on the TITLE line.
|
|
#
|
|
# FULL_TITLE defines the full title for the book as it should appear
|
|
# next to the icon on an InSight bookshelf.
|
|
#
|
|
# VERSION defines the version number for this release of the product
|
|
# and is displayed when the 'Product Info' item off the 'Help' menu is
|
|
# selected.
|
|
#
|
|
# TITLE = SiliconSurf
|
|
# FULL_TITLE = "Silicon Surf Help Book"
|
|
# VERSION = 1.0
|
|
|
|
TITLE = DevDriver_PG
|
|
FULL_TITLE = "IRIX Device Driver Programmer's Guide"
|
|
VERSION = 007-0911-140, 4/99
|
|
|
|
include ${ROOT}/usr/include/make/commonbookdefs
|
|
|
|
# Location 2: The BOOKSHELF, BOOK_LANG, DOC_TYPE, and HIDDEN Variables
|
|
#
|
|
# The BOOKSHELF variable defines the bookshelf that the book will
|
|
# appear on in the Insight library view. Valid entries for SGI
|
|
# Tech Pubs are SGI_EndUser (the default), SGI_Developer, and
|
|
# SGI_Admin.
|
|
# BOOKSHELF = /usr/share/Insight/library/SGI_bookshelves/SGI_EndUser
|
|
BOOKSHELF = /usr/share/Insight/library/SGI_bookshelves/SGI_Developer
|
|
|
|
# The BOOK_ICON variable defines the icon the book will have on the
|
|
# bookshelf. The values available are 'sgi_end_user' for End User books
|
|
# 'sgi_admin' for Administrator books, 'sgi_developer' for Developer books,
|
|
# 'binder' for Support and other "binder" type books, and 'generic' for all
|
|
# other books. The default is 'generic'.
|
|
# BOOK_ICON = generic
|
|
BOOK_ICON = sgi_developer
|
|
|
|
# The BOOK_LANG variable defines the base language of the book and
|
|
# changes translator-defined strings in the book to the specified language.
|
|
# The supported values are C (the default), which is English; de for
|
|
# German; and fr for French. Case of the letters is important. No other
|
|
# values are supported other than C, de, and fr.
|
|
# BOOK_LANG = C
|
|
BOOK_LANG = C
|
|
|
|
# The DTD variable defines the Document Type Definition that the
|
|
# SGML conforms to. Currently available options are SGIDOC for the
|
|
# standard SGI DTD; XHELP for the XHelp DTD; DOCBOOK for the Davenport
|
|
# DocBook DTD, and OTHER for any customized DTD. Case of the letters
|
|
# is important.
|
|
#
|
|
# If OTHER is specified on the DTD variable then DTD specific
|
|
# stylesheets must be created and placed in a directory called 'styles',
|
|
# a booklist.txt file must be created, an EBT specific DTD must be
|
|
# created and called TITLE.dtd, and if the files needs a MIF to SGML
|
|
# translator then that must be specified on a variable called
|
|
# OTHER_TRANSLATOR - specifying any other arguments that that translator
|
|
# might need - other than the file to translate.
|
|
#
|
|
# All other DTD's automatically set up these for you. The default
|
|
# is to use the SGIDOC DTD.
|
|
# DTD = SGIDOC
|
|
DTD = SGIDOC
|
|
|
|
# The DOC_TYPE variable defines the SGML tag type for the contents of
|
|
# the book. All Tech Pubs books are MANUAL (which is the default) while
|
|
# CSD Support books should be SUPPORT. No other values are supported.
|
|
# DOC_TYPE = MANUAL
|
|
DOC_TYPE = MANUAL
|
|
|
|
# The SORT_ORDER variable defines the order this book should appear on
|
|
# the bookshelf. It is a numeric value that can be used to sort the
|
|
# books on a bookshelf. This number should be gotten from your
|
|
# production editor. A default of 999 is used if none is specified.
|
|
|
|
# SORT_ORDER = 006111 # same as -050 version
|
|
|
|
# The HIDDEN variable defines whether this book will be displayed when
|
|
# this book is accessed via the InSight library browser rather than the
|
|
# SGIHelp browser from the application. The default is to keep XHELP
|
|
# based books hidden and all other's not hidden.
|
|
#
|
|
# If you need to define a value other than the default, uncomment the
|
|
# appropriate line and define the value.
|
|
# HIDDEN = FALSE
|
|
HIDDEN = FALSE
|
|
|
|
# Location 3: The BOOK_FILES Variable
|
|
#
|
|
# List the content files in *CORRECT* order that they appear in the book.
|
|
# DO NOT list any generated files (i.e., TOC, LOT, IX, etc).
|
|
# Use trailing '\' for continuing onto the next line.
|
|
# Don't end the last line of file names with trailing '\'.
|
|
# Each line of filenames after the first line should have a leading
|
|
# tab character.
|
|
###
|
|
### NOTE: insert the following 2 lines in their numeric sequence for
|
|
### the spring-96 (Moosehead/Lego) edition, not forgetting backslashes.
|
|
# part9.doc
|
|
# 19-pio.doc
|
|
#
|
|
BOOK_FILES = \
|
|
front.doc intro.doc \
|
|
part1.doc \
|
|
01-physmem.doc \
|
|
02-confiles.doc \
|
|
03-drvrtypes.doc \
|
|
EndPart \
|
|
part2.doc \
|
|
04-vmepio.doc \
|
|
05-dslib.doc \
|
|
06-ei.doc \
|
|
EndPart \
|
|
part3.doc \
|
|
08-drvrstruct.doc \
|
|
09-ddkidabi.doc \
|
|
10-drvrbuild.doc \
|
|
11-drvrdebug.doc \
|
|
12-drvrexamp.doc \
|
|
EndPart \
|
|
part4.doc \
|
|
13-vmehw.doc \
|
|
14-vmesvcs.doc \
|
|
14.1Y-vmehw.doc \
|
|
14.1Z-vmesvcs.doc \
|
|
EndPart \
|
|
part5.doc \
|
|
15-scsi.doc \
|
|
EndPart \
|
|
part6.doc \
|
|
16-network.doc \
|
|
EndPart \
|
|
part7.doc \
|
|
17-eisa.doc \
|
|
EndPart \
|
|
part8.doc \
|
|
18-gio.doc \
|
|
EndPart \
|
|
part9.doc \
|
|
19-pci.doc \
|
|
20-pcisw.doc \
|
|
EndPart \
|
|
part10.doc \
|
|
21-streams.doc \
|
|
EndPart \
|
|
xA-dkapi.doc \
|
|
xB-io4prob.doc \
|
|
gloss.doc
|
|
|
|
#
|
|
# Kudzu should be the last release supporting the Indigo2 chassis,
|
|
# so future revs can finally drop part7 and part8.
|
|
|
|
# NOTES ON FIGURES:
|
|
#
|
|
# Every figure you want to appear in paper and online MUST appear
|
|
# only once on the following lines.
|
|
#
|
|
# All figure names must be listed as they appear in the 'orig' directory.
|
|
#
|
|
# For any composite figures - list each file on the PRINT_BW line.
|
|
|
|
# Location 4: The PRINT_BW Variable
|
|
#
|
|
# List the name of each .rgb figure from the orig directory that
|
|
# should be converted to black and white in the print directory.
|
|
# These figures will be converted to color GIF online.
|
|
#
|
|
# PRINT_BW = figure1.rgb figure2.rgb
|
|
|
|
PRINT_BW =
|
|
|
|
# Location 5: The PRINT_COLOR Variable
|
|
#
|
|
# List the name of each .rgb figure from the orig directory that should
|
|
# be kept in color in the print directory. These figures will be
|
|
# converted to color GIF online.
|
|
#
|
|
# Also list any .rgb figures in the orig directory that have been
|
|
# processed to b/w using tobw. Note that such figures will appear
|
|
# in black and white online.
|
|
#
|
|
# If you don't want a figure converted to GIF online, but kept in
|
|
# 24-bit RGB, use the RGB variable instead of the PRINT_COLOR variable.
|
|
#
|
|
# PRINT_COLOR = figure3.rgb figure4.rgb
|
|
|
|
PRINT_COLOR =
|
|
|
|
# Location 6: The PostScript Variable
|
|
#
|
|
# List the name of each PostScript figure in the orig directory that
|
|
# should be remain PostScript in the print directory and convert to
|
|
# GIF online.
|
|
#
|
|
# PostScript = figure5.ps figure6.ai
|
|
|
|
PostScript = \
|
|
01-cpu.memory.access.ai \
|
|
01-cpu.device.registers.access.ai \
|
|
01-device.access.to.memory.ai \
|
|
01-device.access.thru.bus.adapt.ai \
|
|
01-32.bit.address.space.ai \
|
|
01-32.bit.virt.addr.format.ai \
|
|
01-64.bit.address.space.ai \
|
|
01-64.bit.virt.addr.format.ai \
|
|
01-phys.mem.access.add.decod.ai \
|
|
01-O2.physical.address.ai \
|
|
01-O2.fetch.op.ai \
|
|
02-typical.hwgraph.ai \
|
|
03-device.open.ai \
|
|
03-device.control.ai \
|
|
03-kernel.pio.ai \
|
|
03-memory.mapping.ai \
|
|
03-dma.i.o.ai \
|
|
05-scsi.dev.minor.no.ai \
|
|
09-alenlist.ai \
|
|
13-vme.deskside.ai \
|
|
13-vme.to.system.bus.ai \
|
|
13-cpu.xio.pci.vme.ai \
|
|
13-vmecc.diagram.ai \
|
|
13-IOaddr.to.sysaddr.ai \
|
|
13-vme.cycle.time.ai \
|
|
15-scsi.hwgraph.ai \
|
|
16-net.overv.ai \
|
|
17-overview.eisa.bus.ai \
|
|
17-eisa.mfid.ai \
|
|
18-gio.sysad.ai \
|
|
19-pci.overview.ai
|
|
|
|
# Location 7: The GIF Variable
|
|
#
|
|
# List the name of each .gif figure in the orig directory that
|
|
# should be kept GIF in both the print and online directories.
|
|
#
|
|
# GIF = figure7.gif
|
|
|
|
GIF =
|
|
|
|
# Location 8: The RGB Variable
|
|
#
|
|
# List the name of each .rgb figure from the orig directory that
|
|
# should be kept 24-bit RGB in both the print and online directories.
|
|
#
|
|
# RGB = figure8.rgb
|
|
|
|
RGB =
|
|
|
|
# Location 9: The XWD Variable
|
|
#
|
|
# List the name of each .xwd figure from the orig directory that
|
|
# should be kept in XWD format in the print directory and converted
|
|
# to GIF online.
|
|
#
|
|
# XWD = figure9.xwd
|
|
|
|
XWD =
|
|
|
|
#
|
|
# Location 10: The BW Variable
|
|
#
|
|
# List the name of each .bw figure from the orig directory that
|
|
# has already been run through tobw and is referenced in your book
|
|
# by it's .bw suffix
|
|
#.
|
|
# The files should not appear on any of the above PRINT_ lines.
|
|
# These images will remain in black and white online as well.
|
|
#
|
|
# BW = figure10.bw
|
|
|
|
BW =
|
|
|
|
# Location 11: The INLINE_MEDIA Variable
|
|
#
|
|
# List the name of any inline media objects from the orig directory
|
|
# that are referenced by your book. These could be movie, audio, and
|
|
# Inventor files.
|
|
#
|
|
# INLINE_MEDIA = movie.mv
|
|
|
|
INLINE_MEDIA =
|
|
|
|
# Location 12: The MISC_FILES Variable
|
|
#
|
|
# List the name of any other files that you want to be installed in the
|
|
# figures directory. These files must exist in the orig directory and
|
|
# would be files like the hot-spot data files, auxillary files for
|
|
# the INLINE_MEDIA files, C program text, and any other files that
|
|
# you absoluletly want to have installed with the book.
|
|
#
|
|
# NOTE: No QA testing will be done with these figures since they may
|
|
# not be referenced directly by the SGML source file but rather indirectly
|
|
# via other files. These files will be copied down and shipped with the
|
|
# book so make sure you don't list any cruft on this line.
|
|
#
|
|
# NOTE: If you do NOT have any figures that should be copied down - then
|
|
# do NOT uncomment this line as an empty definition will break your build.
|
|
#
|
|
# MISC_FILES = figure1.rgb.hot
|
|
|
|
# MISC_FILES =
|
|
|
|
include ${COMMONBOOKRULES}
|
|
include ${COMMONPREPRULES}
|