head	1.6;
access;
symbols
	libdrm-1_0_4:1.6
	trunk-20021125:1.5
	mesa-4-1-branch:1.5.0.2
	start:1.1.1.1
	vendor:1.1.1;
locks; strict;
comment	@# @;


1.6
date	2003.06.25.14.40.07;	author jrfonseca;	state Exp;
branches;
next	1.5;

1.5
date	2002.04.20.18.59.28;	author jrfonseca;	state Exp;
branches;
next	1.4;

1.4
date	2002.04.14.15.09.44;	author jrfonseca;	state Exp;
branches;
next	1.3;

1.3
date	2002.04.14.11.28.08;	author jrfonseca;	state Exp;
branches;
next	1.2;

1.2
date	2002.03.13.18.57.33;	author jrfonseca;	state Exp;
branches;
next	1.1;

1.1
date	2002.01.30.11.16.41;	author jrfonseca;	state Exp;
branches
	1.1.1.1;
next	;

1.1.1.1
date	2002.01.30.11.16.41;	author jrfonseca;	state Exp;
branches;
next	;


desc
@@


1.6
log
@Switch the source format to DocBook XML.
@
text
@# Generates online and print versions of DocBook source files.


# DocBook source files.

SOURCES = $(wildcard *.xml) terms.dtd

TARGET = DRI-Devel-FAQ

LDP = /usr/share/sgml/docbook/stylesheet/xsl/ldp


# Build rules.

html: index.html

htm: $(TARGET).htm

pdf: $(TARGET).pdf

index.html: $(SOURCES)
	xsltproc $(LDP)/ldp-html-chunk.xsl $(TARGET).xml
	
$(TARGET).fo: $(SOURCES)
	xsltproc -o $@@ $(LDP)/ldp-print.xsl $(TARGET).xml
	
$(TARGET).htm: $(SOURCES)
	xsltproc -o $@@ $(LDP)/ldp-html-chunk.xsl $(TARGET).xml

$(TARGET).pdf: $(TARGET).fo
	#pdfxmltex $<
	fop $< $@@

terms.dtd: glossary.xml terms.py
	python terms.py $< > $@@

all: html htm pdf

clean:
	rm -f terms.dtd
	rm -f *.html htm *.fo *.pdf


# Install rules.

INSTALL_SSH = ssh
INSTALL_SCP = scp
INSTALL_HOST = jrfonseca@@shell.sourceforge.net
INSTALL_DIR = /home/groups/d/dr/dri/htdocs/doc/faq

install: all
	$(INSTALL_SSH) $(INSTALL_HOST) mkdir -p $(INSTALL_DIR)
	$(INSTALL_SCP) *.html $(INSTALL_HOST):$(INSTALL_DIR)

	$(INSTALL_SSH) $(INSTALL_HOST) mkdir -p $(INSTALL_DIR)/other-formats/html-single
	$(INSTALL_SCP) *.htm $(INSTALL_HOST):$(INSTALL_DIR)/other-formats/html-single

	$(INSTALL_SSH) $(INSTALL_HOST) mkdir -p $(INSTALL_DIR)/other-formats/pdf
	$(INSTALL_SCP) *.pdf $(INSTALL_HOST):$(INSTALL_DIR)/other-formats/pdf

	$(INSTALL_SSH) $(INSTALL_HOST) mkdir -p $(INSTALL_DIR)/other-formats/xml
	$(INSTALL_SCP) *.{xml,dtd} $(INSTALL_HOST):$(INSTALL_DIR)/other-formats/xml

@


1.5
log
@Small corrections.
Fitted some of the miscellaneous material in the implementation.
Added a reference to the most interesting "Linux Device Driver" book.
Bumped the FAQ revision to 1.0.
@
text
@d1 1
a1 1
# Generates online and print versions of SGML source file.
a2 1
BASENAME=DRI-Devel-FAQ
d4 1
a4 28
# SGML source files.
SGML_FILE=$(BASENAME).sgml
SGML_FILES=\
	$(SGML_FILE) \
	about.sgml \
	introduction.sgml \
	architecture.sgml \
	implementation.sgml \
	hardware.sgml \
	testing.sgml \
	miscellaneous.sgml \
	authorship.sgml \
	glossary.sgml \
	references.sgml \
	terms.dtd

# Stylesheets
DSL_PRINT=`pwd`/ldp.dsl\#print
DSL_HTML=`pwd`/ldp.dsl\#html

# Generated files.
HTML_FILE=index.html
HTM_FILE=$(BASENAME).htm
TEX_FILE=$(BASENAME).tex
RTF_FILE=$(BASENAME).rtf
PDF_FILE=$(BASENAME).pdf
DVI_FILE=$(BASENAME).dvi
PS_FILE=$(BASENAME).ps
d6 1
d8 1
a8 1
# Build rules.
d10 1
a10 1
html: $(HTML_FILE)
a11 1
htm: $(HTM_FILE)
d13 1
a13 1
tex: $(TEX_FILE)
d15 1
a15 1
rtf: $(RTF_FILE)
d17 1
a17 1
pdf: $(PDF_FILE)
d19 1
a19 1
dvi: $(DVI_FILE)
d21 8
a28 1
ps: $(PS_FILE)
d30 3
a32 1
all: html htm pdf ps
d34 2
a35 3
clean:
	rm -f $(BASENAME).{htm,log,aux,ps,pdf,tex,dvi,rtf,fot,out}
	rm -f *.html
d37 1
a37 2
distclean: clean
	rm -f $(BASENAME).tgz
d39 3
a41 4
package:
	rm -f $(BASENAME).tgz
	tar -C .. -czf /tmp/$(BASENAME).tgz $(wildcard *.sgml)
	mv /tmp/$(BASENAME).tgz .
a42 3
dist: clean package

distall: all package
d61 2
a62 33
	$(INSTALL_SSH) $(INSTALL_HOST) mkdir -p $(INSTALL_DIR)/other-formats/ps
	$(INSTALL_SCP) *.ps $(INSTALL_HOST):$(INSTALL_DIR)/other-formats/ps

	$(INSTALL_SSH) $(INSTALL_HOST) mkdir -p $(INSTALL_DIR)/other-formats/sgml
	$(INSTALL_SCP) *.{sgml,dtd} $(INSTALL_HOST):$(INSTALL_DIR)/other-formats/sgml

# Compile rules.

terms.dtd: glossary.sgml terms.py
	./terms.py $< > $@@

$(HTML_FILE): $(SGML_FILES)
	jade -t sgml -i html -d $(DSL_HTML) $(SGML_FILE)

$(HTM_FILE): $(SGML_FILES)
	jade -t sgml -i html -V nochunks -d $(DSL_HTML) $(SGML_FILE) > $(HTM_FILE)

$(TEX_FILE): $(SGML_FILES)
	jade -t tex -d $(DSL_PRINT) $(SGML_FILE)

$(RTF_FILE): $(SGML_FILES)
	jade -t rtf -d $(DSL_PRINT) $(SGML_FILE)

# [pdf]jadetex is run 3 times to resolve references.
$(PDF_FILE): $(TEX_FILE)
	pdfjadetex $(TEX_FILE)
	pdfjadetex $(TEX_FILE)
	pdfjadetex $(TEX_FILE)

$(DVI_FILE): $(TEX_FILE)
	jadetex $(TEX_FILE)
	jadetex $(TEX_FILE)
	jadetex $(TEX_FILE)
a63 2
$(PS_FILE): $(DVI_FILE)
	dvips -o $(PS_FILE) $(DVI_FILE)
@


1.4
log
@Added a section about binary compatibility from Jens Owen.
Added a new section focusing on the implementation details, including new material covering topics such as texture management, Mesa's graphics pipeline and clipping.
@
text
@a70 1
ifdef SF
a74 6
else
INSTALL_SSH = ssh
INSTALL_SCP = scp
INSTALL_HOST = mefriss1.swan.ac.uk
INSTALL_DIR = /home/jfonseca/public_html/dri/faq
endif
@


1.3
log
@Updated the Makefile for uploading the FAQ in other formats to the DRI website.
Created an automated system for creating glossary links easily, e.g., to have an embebed link to the glossary definition of DMA one just has to write &DMA; instead.
Bootstraped a new section named "Implementation" which will receive some of the in-depth content of the "Architecture" section.
Remove the empty file "techniques.sgml" as its potential content will be now on "implementation.sgml" instead.
@
text
@d74 1
a74 1
INSTALL_HOST = jrfonseca@@shell.sourceforge.net:
@


1.2
log
@Added a makefile target to upload the HTML version of the FAQ to the DRI website.
@
text
@d12 2
a14 2
	techniques.sgml \
	hardware.sgml \
d18 2
a19 1
	references.sgml
d51 1
a51 1
all: html htm tex rtf pdf dvi ps
d69 11
d81 1
d84 2
a85 8
	rm -f $(INSTALL_DIR)/$(BASENAME).{htm,log,aux,ps,pdf,tex,dvi,rtf,fot}
	cp -f $(BASENAME).{htm,ps,pdf,rtf} $(INSTALL_DIR)
	mkdir -p $(INSTALL_DIR)/html/
	rm -f $(INSTALL_DIR)/html/*.html
	cp -f *.html $(INSTALL_DIR)/html/
	mkdir -p $(INSTALL_DIR)/sgml/
	rm -f $(INSTALL_DIR)/sgml/*.sgml
	cp -f *.sgml $(INSTALL_DIR)/sgml/
d87 2
a88 1
INSTALL_SF_DIR = jrfonseca@@shell.sourceforge.net:/home/groups/d/dr/dri/htdocs/doc/faq
d90 8
a97 2
install_sf: html
	scp *.html $(INSTALL_SF_DIR)
d100 3
@


1.1
log
@Initial revision
@
text
@d80 4
@


1.1.1.1
log
@Initial submition
@
text
@@