xref: /petsc/makefile (revision c3d102fe2dfc19c1832704c537829f04ceb136a2)
1#
2# This is the makefile for installing PETSc. See
3# http://www.mcs.anl.gov/petsc/petsc-2/documentation/installation.html for directions on installing PETSc.
4# See also bmake/common for additional commands.
5#
6ALL: all
7LOCDIR = .
8DIRS   = src include
9
10include ${PETSC_DIR}/bmake/common/base
11include ${PETSC_DIR}/bmake/common/test
12
13#
14# Basic targets to build PETSc libraries.
15# all: builds the c, fortran, and f90 libraries
16all:
17	@${OMAKE}  PETSC_ARCH=${PETSC_ARCH}  chkpetsc_dir
18	-@${OMAKE} all_build 2>&1 | tee make_log_${PETSC_ARCH}
19all_build: chk_petsc_dir chklib_dir info info_h deletelibs  build shared
20#
21# Prints information about the system and version of PETSc being compiled
22#
23info:
24	-@echo "=========================================="
25	-@echo " "
26	-@echo "See docs/troubleshooting.html and docs/bugreporting.html"
27	-@echo "for help with installation problems. Please send EVERYTHING"
28	-@echo "printed out below when reporting problems"
29	-@echo " "
30	-@echo "To subscribe to the PETSc users mailing list, send mail to "
31	-@echo "majordomo@mcs.anl.gov with the message: "
32	-@echo "subscribe petsc-announce"
33	-@echo " "
34	-@echo "=========================================="
35	-@echo On `date` on `hostname`
36	-@echo Machine characteristics: `uname -a`
37	-@echo "-----------------------------------------"
38	-@echo "Using PETSc directory: ${PETSC_DIR}"
39	-@echo "Using PETSc arch: ${PETSC_ARCH}"
40	-@echo "-----------------------------------------"
41	-@grep "define PETSC_VERSION" ${PETSC_DIR}/include/petscversion.h | ${SED} "s/........//"
42	-@echo "-----------------------------------------"
43	-@echo "Using configuration flags:"
44	-@grep "\#define " ${PETSC_DIR}/bmake/${PETSC_ARCH}/petscconf.h
45	-@echo "-----------------------------------------"
46	-@echo "Using include paths: ${PETSC_INCLUDE}"
47	-@echo "Using PETSc flags: ${PETSCFLAGS} ${PCONF}"
48	-@echo "------------------------------------------"
49	-@echo "Using C/C++ compiler: ${CC} ${COPTFLAGS} ${CPPFLAGS}"
50	-@echo "C/C++ Compiler version: " `${CCV}`
51	-@if [ "${FC}" != "" ]; then \
52	   echo "Using Fortran compiler: ${FC} ${FOPTFLAGS} ${FPPFLAGS}";\
53	   echo "Fortran Compiler version: " `${FCV}`;\
54         fi
55	-@echo "-----------------------------------------"
56	-@echo "Using C/C++ linker: ${CC_LINKER}"
57	-@if [ "${FC}" != "" ]; then \
58	   echo "Using Fortran linker: ${FC_LINKER}";\
59         fi
60	-@echo "-----------------------------------------"
61	-@echo "Using libraries: ${PETSC_LIB}"
62	-@echo "------------------------------------------"
63	-@echo "Using mpirun: ${MPIRUN}"
64	-@echo "=========================================="
65#
66#
67MINFO = ${PETSC_DIR}/bmake/${PETSC_ARCH}/petscmachineinfo.h
68info_h:
69	-@$(RM) -f MINFO ${MINFO}
70	-@echo  "static const char *petscmachineinfo = \"  " >> MINFO
71	-@echo  "Libraries compiled on `date` on `hostname` " >> MINFO
72	-@echo  Machine characteristics: `uname -a` "" >> MINFO
73	-@echo  "Using PETSc directory: ${PETSC_DIR}" >> MINFO
74	-@echo  "Using PETSc arch: ${PETSC_ARCH}" >> MINFO
75	-@echo  "-----------------------------------------\"; " >> MINFO
76	-@echo  "static const char *petsccompilerinfo = \"  " >> MINFO
77	-@echo  "Using C compiler: ${CC} ${COPTFLAGS} ${CCPPFLAGS} " >> MINFO
78	-@echo  "C Compiler version:"  >> MINFO ; ${C_CCV} >> MINFO 2>&1 ; true
79	-@echo  "C++ Compiler version:"  >> MINFO; ${CXX_CCV} >> MINFO 2>&1 ; true
80	-@echo  "Using Fortran compiler: ${FC} ${FOPTFLAGS} ${FCPPFLAGS}" >> MINFO
81	-@echo  "Fortran Compiler version:" >> MINFO ; ${FCV} >> MINFO 2>&1 ; true
82	-@echo  "-----------------------------------------\"; " >> MINFO
83	-@echo  "static const char *petsccompilerflagsinfo = \"  " >> MINFO
84	-@echo  "Using PETSc flags: ${PETSCFLAGS} ${PCONF}" >> MINFO
85	-@echo  "-----------------------------------------" >> MINFO
86	-@echo  "Using configuration flags:" >> MINFO
87	-@echo  "-----------------------------------------" >> MINFO
88	-@echo  "Using include paths: ${PETSC_INCLUDE}" >> MINFO
89	-@echo  "------------------------------------------\"; " >> MINFO
90	-@echo  "static const char *petsclinkerinfo = \"  " >> MINFO
91	-@echo  "Using C linker: ${CLINKER}" >> MINFO
92	-@echo  "Using Fortran linker: ${FLINKER}" >> MINFO
93	-@echo  "Using libraries: ${PETSC_LIB} \"; " >> MINFO
94	-@cat MINFO | ${SED} -e 's/\^M//g' | ${SED} -e 's/\\/\\\\/g' | ${SED} -e 's/$$/ \\n\\/' | sed -e 's/\;  \\n\\/\;/'> MINFO_
95	-@cat MINFO_ | ${SED} -e 's/\
96//g'  > /dev/null; foobar=$$?; \
97          if [ "$$foobar" = "0" ]; then \
98	    cat MINFO_ | ${SED} -e 's/\
99//g' > ${MINFO}; \
100          else cat MINFO | ${SED} -e 's/\^M//g' | ${SED} -e 's/\\/\\\\/g' | ${SED} -e 's/$$/ \\n\\/' | sed -e 's/\;  \\n\\/\;/'> ${MINFO}; \
101          fi
102	-@$(RM) MINFO MINFO_
103
104#
105# Builds the PETSc libraries
106# This target also builds fortran77 and f90 interface
107# files and compiles .F files
108#
109build:
110	-@echo "BEGINNING TO COMPILE LIBRARIES IN ALL DIRECTORIES"
111	-@echo "========================================="
112	-@${OMAKE}  PETSC_ARCH=${PETSC_ARCH} PETSC_DIR=${PETSC_DIR} ACTION=libfast tree
113	@grep -i " error " make_log_${PETSC_ARCH} > /dev/null; if [ "$$?" = 0 ]; then \
114           echo "Error during compile, check " make_log_${PETSC_ARCH}; \
115           echo "Send it and configure.log to petsc-maint@mcs.anl.gov"; exit 1; fi
116	-@${RANLIB} ${PETSC_LIB_DIR}/*.${AR_LIB_SUFFIX}
117	-@echo "Completed building libraries"
118	-@echo "========================================="
119#
120# Builds PETSc test examples for a given architecture
121#
122test:
123	-@echo "Running test examples to verify correct installation"
124	@cd src/snes/examples/tutorials; ${OMAKE} PETSC_ARCH=${PETSC_ARCH}  PETSC_DIR=${PETSC_DIR} testex19
125	@if [ "${FC}" != "" ]; then cd src/snes/examples/tutorials; ${OMAKE} PETSC_ARCH=${PETSC_ARCH}  PETSC_DIR=${PETSC_DIR} testex5f; fi;
126	-@echo "Completed test examples"
127
128testexamples: info
129	-@echo "BEGINNING TO COMPILE AND RUN TEST EXAMPLES"
130	-@echo "Due to different numerical round-off on certain"
131	-@echo "machines some of the numbers may not match exactly."
132	-@echo "========================================="
133	-@${OMAKE} PETSC_ARCH=${PETSC_ARCH}  PETSC_DIR=${PETSC_DIR} ACTION=testexamples_1  tree
134	-@echo "Completed compiling and running test examples"
135	-@echo "========================================="
136testfortran: info
137	-@echo "BEGINNING TO COMPILE AND RUN FORTRAN TEST EXAMPLES"
138	-@echo "========================================="
139	-@echo "Due to different numerical round-off on certain"
140	-@echo "machines or the way Fortran formats numbers"
141	-@echo "some of the results may not match exactly."
142	-@echo "========================================="
143	-@if [ "${FC}" != "" ]; then \
144            ${OMAKE} PETSC_ARCH=${PETSC_ARCH} PETSC_DIR=${PETSC_DIR} ACTION=testexamples_3 tree; \
145            echo "Completed compiling and running Fortran test examples"; \
146          else \
147            echo "Error: No FORTRAN compiler available"; \
148          fi
149	-@echo "========================================="
150testexamples_uni: info
151	-@echo "BEGINNING TO COMPILE AND RUN TEST UNI-PROCESSOR EXAMPLES"
152	-@echo "Due to different numerical round-off on certain"
153	-@echo "machines some of the numbers may not match exactly."
154	-@echo "========================================="
155	-@${OMAKE} PETSC_ARCH=${PETSC_ARCH} PETSC_DIR=${PETSC_DIR} ACTION=testexamples_4  tree
156	-@echo "Completed compiling and running uniprocessor test examples"
157	-@echo "========================================="
158testfortran_uni: info
159	-@echo "BEGINNING TO COMPILE AND RUN TEST UNI-PROCESSOR FORTRAN EXAMPLES"
160	-@echo "Due to different numerical round-off on certain"
161	-@echo "machines some of the numbers may not match exactly."
162	-@echo "========================================="
163	-@if [ "${FC}" != "" ]; then \
164            ${OMAKE} PETSC_ARCH=${PETSC_ARCH} PETSC_DIR=${PETSC_DIR} ACTION=testexamples_9  tree; \
165            echo "Completed compiling and running uniprocessor fortran test examples"; \
166          else \
167            echo "Error: No FORTRAN compiler available"; \
168          fi
169	-@
170	-@echo "========================================="
171
172# Ranlib on the libraries
173ranlib:
174	${RANLIB} ${PETSC_LIB_DIR}/*.${AR_LIB_SUFFIX}
175
176# Deletes PETSc libraries
177deletelibs:
178	-${RM} -f ${PETSC_LIB_DIR}/*
179
180# Cleans up build
181allclean: deletelibs
182	-@${OMAKE} PETSC_ARCH=${PETSC_ARCH} PETSC_DIR=${PETSC_DIR} ACTION=clean tree
183
184
185#
186# Check if PETSC_DIR variable specified is valid
187#
188chk_petsc_dir:
189	@if [ ! -f ${PETSC_DIR}/include/petscversion.h ]; then \
190	  echo "Incorrect PETSC_DIR specified: ${PETSC_DIR}!"; \
191	  echo "You need to use / to separate directories, not \\!"; \
192	  echo "Aborting build"; \
193	  false; fi
194#
195#
196install:
197	-@if [ "${INSTALL_DIR}" == "${PETSC_DIR}" ]; then \
198	  echo "Install directory is current directory; nothing needs to be done";\
199        else \
200	  echo Installing PETSc at ${INSTALL_DIR};\
201          if [ ! -d `dirname ${INSTALL_DIR}` ]; then \
202	    ${MKDIR} `dirname ${INSTALL_DIR}` ; \
203          fi;\
204          if [ ! -d ${INSTALL_DIR} ]; then \
205	    ${MKDIR} ${INSTALL_DIR} ; \
206          fi;\
207          cp -fr include ${INSTALL_DIR};\
208          if [ ! -d ${INSTALL_DIR}/bmake ]; then \
209	    ${MKDIR} ${INSTALL_DIR}/bmake ; \
210          fi;\
211          cp -f bmake/adic* bmake/variables ${INSTALL_DIR}/bmake ; \
212          cp -fr bmake/common ${INSTALL_DIR}/bmake;\
213          cp -fr bmake/${PETSC_ARCH} ${INSTALL_DIR}/bmake;\
214          cp -fr bin ${INSTALL_DIR};\
215          if [ ! -d ${INSTALL_DIR}/lib ]; then \
216	    ${MKDIR} ${INSTALL_DIR}/lib ; \
217          fi;\
218          for i in lib/lib*; do \
219            if [ ! -d ${INSTALL_DIR}/$${i} ]; then \
220              ${MKDIR} ${INSTALL_DIR}/$${i};\
221            fi; \
222            if [ -d $${i}/${PETSC_ARCH} ]; then \
223              cp -fr $${i}/${PETSC_ARCH} ${INSTALL_DIR}/$${i};\
224              ${RANLIB}  ${INSTALL_DIR}/$${i}/*.a > /dev/null 2>&1 ;\
225              ${OMAKE} PETSC_ARCH=${PETSC_ARCH} PETSC_DIR=${INSTALL_DIR} shared; \
226            fi;\
227          done;\
228          echo "sh/bash: PETSC_DIR="${INSTALL_DIR}"; export PETSC_DIR";\
229          echo "csh/tcsh: setenv PETSC_DIR "${INSTALL_DIR} ;\
230          echo "The do make test to verify correct install";\
231        fi;
232
233install_src:
234	-@if [ "${INSTALL_DIR}" == "${PETSC_DIR}" ]; then \
235	  echo "You did not set a directory to install to";\
236        else \
237	  echo Installing PETSc source at ${INSTALL_DIR};\
238          if [ ! -d `dirname ${INSTALL_DIR}` ]; then \
239	    ${MKDIR} `dirname ${INSTALL_DIR}` ; \
240          fi;\
241          if [ ! -d ${INSTALL_DIR} ]; then \
242	    ${MKDIR} ${INSTALL_DIR} ; \
243          fi;\
244          cp -fr src ${INSTALL_DIR};\
245        fi;
246
247install_docs:
248	-@if [ "${INSTALL_DIR}" == "${PETSC_DIR}" ]; then \
249	  echo "You did not set a directory to install to";\
250        else \
251	  echo Installing PETSc documentation at ${INSTALL_DIR};\
252          if [ ! -d `dirname ${INSTALL_DIR}` ]; then \
253	    ${MKDIR} `dirname ${INSTALL_DIR}` ; \
254          fi;\
255          if [ ! -d ${INSTALL_DIR} ]; then \
256	    ${MKDIR} ${INSTALL_DIR} ; \
257          fi;\
258          cp -fr docs ${INSTALL_DIR};\
259          ${RM} -fr docs/tex;\
260        fi;
261# ------------------------------------------------------------------
262#
263# All remaining actions are intended for PETSc developers only.
264# PETSc users should not generally need to use these commands.
265#
266
267# To access the tags in EMACS, type M-x visit-tags-table and specify
268# the file petsc/TAGS.
269# 1) To move to where a PETSc function is defined, enter M-. and the
270#     function name.
271# 2) To search for a string and move to the first occurrence,
272#     use M-x tags-search and the string.
273#     To locate later occurrences, use M-,
274# Builds all etags files
275alletags:
276	-@maint/generateetags.py
277	-@find python -type f -name "*.py" |grep -v SCCS | xargs etags -o TAGS_PYTHON
278
279allfortranstubs:
280	-@maint/generatefortranstubs.py ${BFORT}
281#
282# These are here for the target allci and allco, and etags
283#
284
285BMAKEFILES = bmake/common/base bmake/common/test bmake/adic.init bmake/adicmf.init
286DOCS	   = bmake/readme
287SCRIPTS    = maint/builddist  maint/wwwman maint/xclude maint/bugReport.py maint/buildconfigtest maint/builddistlite \
288             maint/buildtest maint/checkBuilds.py maint/copylognightly maint/copylognightly.tao maint/countfiles maint/findbadfiles \
289             maint/fixinclude maint/getexlist maint/getpdflabels.py maint/helpindex.py maint/hosts.local maint/hosts.solaris  \
290             maint/lex.py  maint/mapnameslatex.py maint/startnightly maint/startnightly.tao maint/submitPatch.py \
291             maint/update-docs.py  maint/wwwindex.py maint/xcludebackup maint/xcludecblas maint/zap maint/zapall \
292             python/PETSc/Configure.py python/PETSc/Options.py \
293             python/PETSc/packages/*.py python/PETSc/utilities/*.py
294
295chk_loc:
296	@if [ ${LOC}foo = foo ] ; then \
297	  echo "*********************** ERROR ************************" ; \
298	  echo " Please specify LOC variable for eg: make allmanualpages LOC=/sandbox/petsc"; \
299	  echo "******************************************************";  false; fi
300	@${MKDIR} ${LOC}/docs/manualpages
301
302# Builds all the documentation - should be done every night
303alldoc: alldoc1 alldoc2
304
305# Build everything that goes into 'doc' dir except html sources
306alldoc1: chk_loc deletemanualpages chk_concepts_dir
307	-${OMAKE} ACTION=manualpages_buildcite tree_basic LOC=${LOC}
308	cd src/docs/tex/manual; ${OMAKE} build_manual.pdf LOC=${LOC}
309	-${OMAKE} ACTION=manualpages tree_basic LOC=${LOC}
310	-maint/wwwindex.py ${PETSC_DIR} ${LOC}
311	-${OMAKE} ACTION=manexamples tree_basic LOC=${LOC}
312	-${OMAKE} manconcepts LOC=${LOC}
313	-${OMAKE} ACTION=getexlist tree_basic LOC=${LOC}
314	-${OMAKE} ACTION=exampleconcepts tree_basic LOC=${LOC}
315	-maint/helpindex.py ${PETSC_DIR} ${LOC}
316	-grep -h PolymorphicSubroutine include/*.h | grep -v '#define ' | sed "s?PetscPolymorphicSubroutine(??g" | cut -f1 -d"{" > tmppoly
317	-maint/processpoly.py ${PETSC_DIR} ${LOC}
318
319# Builds .html versions of the source
320# html overwrites some stuff created by update-docs - hence this is done later.
321alldoc2: chk_loc
322	-${OMAKE} ACTION=html PETSC_DIR=${PETSC_DIR} alltree LOC=${LOC}
323	-maint/update-docs.py ${PETSC_DIR} ${LOC}
324
325alldocclean: deletemanualpages allcleanhtml
326
327# Deletes man pages (HTML version)
328deletemanualpages: chk_loc
329	-@if [ -d ${LOC} -a -d ${LOC}/docs/manualpages ]; then \
330          find ${LOC}/docs/manualpages -type f -name "*.html" -exec ${RM} {} \; ;\
331          ${RM} ${LOC}/docs/exampleconcepts ;\
332          ${RM} ${LOC}/docs/manconcepts ;\
333          ${RM} ${LOC}/docs/manualpages/manualpages.cit ;\
334          maint/update-docs.py ${PETSC_DIR} ${LOC} clean;\
335        fi
336
337allcleanhtml:
338	-${RM} include/adic/*.h.html
339	-${OMAKE} ACTION=cleanhtml PETSC_DIR=${PETSC_DIR} alltree
340
341chk_concepts_dir: chk_loc
342	@if [ ! -d "${LOC}/docs/manualpages/concepts" ]; then \
343	  echo Making directory ${LOC}/docs/manualpages/concepts for library; ${MKDIR} ${LOC}/docs/manualpages/concepts; fi
344#
345
346allci:
347	-@${OMAKE} PETSC_ARCH=${PETSC_ARCH} ACTION=ci  alltree
348
349allco:
350	-@${OMAKE} PETSC_ARCH=${PETSC_ARCH} ACTION=co  alltree
351
352# usage make allrcslabel NEW_RCS_LABEL=v_2_0_28
353allrcslabel:
354	-@${OMAKE} PETSC_ARCH=${PETSC_ARCH} NEW_RCS_LABEL=${NEW_RCS_LABEL} ACTION=rcslabel  alltree
355#
356#   The commands below are for generating ADIC versions of the code;
357# they are not currently used.
358#
359alladicignore:
360	-@${RM} ${INSTALL_LIB_DIR}/adicignore
361	-@${OMAKE}  PETSC_ARCH=${PETSC_ARCH} ACTION=adicignore  tree
362
363alladic:
364	-@echo "Beginning to compile ADIC source code in all directories"
365	-@echo "Using ADIC compiler: ${ADIC_CC} ${CCPPFLAGS}"
366	-@echo "========================================="
367	-@cd include ; \
368           ${ADIC_CC} -s -f 1 ${CCPPFLAGS} petsc.h
369	-@${OMAKE}  PETSC_ARCH=${PETSC_ARCH} ACTION=adic  tree
370	-@cd src/inline ; \
371            ${OMAKE} PETSC_ARCH=${PETSC_ARCH} adic
372
373alladiclib:
374	-@echo "Beginning to compile ADIC libraries in all directories"
375	-@echo "Using compiler: ${CC} ${COPTFLAGS}"
376	-@echo "-----------------------------------------"
377	-@echo "Using PETSc flags: ${PETSCFLAGS} ${PCONF}"
378	-@echo "-----------------------------------------"
379	-@echo "Using configuration flags:"
380	-@grep "define " bmake/${INLUDE_ARCH}/petscconf.h
381	-@echo "-----------------------------------------"
382	-@echo "Using include paths: ${PETSC_INCLUDE}"
383	-@echo "-----------------------------------------"
384	-@echo "Using PETSc directory: ${PETSC_DIR}"
385	-@echo "Using PETSc arch: ${PETSC_ARCH}"
386	-@echo "========================================="
387	-@${RM} -f  ${INSTALL_LIB_DIR}/*adic.${AR_LIB_SUFFIX}
388	-@${OMAKE} PETSC_ARCH=${PETSC_ARCH} ACTION=adiclib  tree
389	-@cd src/adic/src ; \
390            ${OMAKE} PETSC_ARCH=${PETSC_ARCH} lib
391
392# -------------------------------------------------------------------------------
393#
394# Some macros to check if the fortran interface is up-to-date.
395#
396countfortranfunctions:
397	-@cd ${PETSC_DIR}/src/fortran; egrep '^void' custom/*.c auto/*.c | \
398	cut -d'(' -f1 | tr -s  ' ' | cut -d' ' -f2 | uniq | egrep -v "(^$$|Petsc)" | \
399	sed "s/_$$//" | sort > /tmp/countfortranfunctions
400
401countcfunctions:
402	-@ grep extern ${PETSC_DIR}/include/*.h *.h | grep "(" | tr -s ' ' | \
403	cut -d'(' -f1 | cut -d' ' -f3 | grep -v "\*" | tr -s '\012' |  \
404	tr 'A-Z' 'a-z' |  sort > /tmp/countcfunctions
405
406difffortranfunctions: countfortranfunctions countcfunctions
407	-@echo -------------- Functions missing in the fortran interface ---------------------
408	-@${DIFF} /tmp/countcfunctions /tmp/countfortranfunctions | grep "^<" | cut -d' ' -f2
409	-@echo ----------------- Functions missing in the C interface ------------------------
410	-@${DIFF} /tmp/countcfunctions /tmp/countfortranfunctions | grep "^>" | cut -d' ' -f2
411	-@${RM}  /tmp/countcfunctions /tmp/countfortranfunctions
412
413checkbadfortranstubs:
414	-@echo "========================================="
415	-@echo "Functions with MPI_Comm as an Argument"
416	-@echo "========================================="
417	-@cd ${PETSC_DIR}/src/fortran/auto; grep '^void' *.c | grep 'MPI_Comm' | \
418	tr -s ' ' | tr -s ':' ' ' |cut -d'(' -f1 | cut -d' ' -f1,3
419	-@echo "========================================="
420	-@echo "Functions with a String as an Argument"
421	-@echo "========================================="
422	-@cd ${PETSC_DIR}/src/fortran/auto; grep '^void' *.c | grep 'char \*' | \
423	tr -s ' ' | tr -s ':' ' ' |cut -d'(' -f1 | cut -d' ' -f1,3
424	-@echo "========================================="
425	-@echo "Functions with Pointers to PETSc Objects as Argument"
426	-@echo "========================================="
427	-@cd ${PETSC_DIR}/src/fortran/auto; \
428	_p_OBJ=`grep _p_ ${PETSC_DIR}/include/*.h | tr -s ' ' | \
429	cut -d' ' -f 3 | tr -s '\012' | grep -v '{' | cut -d'*' -f1 | \
430	sed "s/_p_//g" | tr -s '\012 ' ' *|' ` ; \
431	for OBJ in $$_p_OBJ; do \
432	grep "$$OBJ \*" *.c | tr -s ' ' | tr -s ':' ' ' | \
433	cut -d'(' -f1 | cut -d' ' -f1,3; \
434	done
435#
436# Automatically generates PETSc exercises in html from the tutorial examples.
437#
438# The introduction for each section is obtained from docs/manualpages/header_${MANSEC} is under RCS and may be edited
439#  (used also in introductions to the manual pages)
440# The overall introduction is in docs/exercises/introduction.html and is under RCS and may be edited
441# The list of exercises is from TUTORIALS in each directory's makefile
442#
443# DO NOT EDIT the pageform.txt or *.htm files generated since they will be automatically replaced.
444# The pagemaker rule is in the file bmake/common (at the bottom)
445#
446# Eventually the line below will replace the two cd in the rule below, it is just this way now for speed
447#	-@${OMAKE} PETSC_DIR=${PETSC_DIR} pagemaker
448#
449exercises:
450	-@echo "========================================="
451	-@echo "Generating HTML tutorial exercises"
452	-@${RM} docs/pageform.txt
453	-@echo "title=\"PETSc Exercises\""                >  docs/pageform.txt
454	-@echo "access_title=Exercise Sections"              >>  docs/pageform.txt
455	-@echo "access_format=short"                        >> docs/pageform.txt
456	-@echo "startpage=../exercises/introduction.htm"  >> docs/pageform.txt
457	-@echo "NONE title=\"Introduction\" command=link src=../exercises/introduction.htm" >> docs/pageform.txt
458	-@echo "Generating HTML for individual directories"
459	-@echo "========================================="
460	-@${OMAKE} PETSC_DIR=${PETSC_DIR} ACTION=pagemaker tree
461	-@echo "Completed HTML for individual directories"
462	-@echo "NONE title=\"<HR>\" " >> docs/pageform.txt;
463	-@echo "NONE title=\"PETSc Documentation\" command=link src=../index.html target=replace" >> docs/pageform.txt
464	/home/MPI/class/mpiexmpl/maint/makepage.new -pageform=docs/pageform.txt -access_extra=/dev/null -outdir=docs/exercises
465	-@echo "========================================="
466
467# Make a tarball of all the Python code
468#   This is currently used to release to the Teragrid
469petscPython.tgz:
470	@tar cvzf $@ --exclude SCCS --exclude BitKeeper --dereference python/
471	-@scp $@ tg-login2.uc.teragrid.org:./
472
473.PHONY: info info_h all all_build build testexamples testfortran testexamples_uni testfortran_uni ranlib deletelibs allclean update chk_petsc_dir \
474        alletags etags etags_complete etags_noexamples etags_makefiles etags_examples etags_fexamples alldoc allmanualpages \
475        allhtml allcleanhtml  allci allco allrcslabel alladicignore alladic alladiclib countfortranfunctions \
476        start_configure configure_petsc configure_clean petscPython.tgz
477
478