Makefile #1

  • //
  • guest/
  • perforce_software/
  • sdp/
  • dev/
  • doc/
  • Makefile
  • View
  • Commits
  • Open Download .zip Download (268 B)
# Makefile for SDP docs

src = $(wildcard *.adoc)
# obj = $(src:.adoc=.pdf)

# LDFLAGS = -lGL -lglut -lpng -lz -lm

build: $(src)
	asciidoctor-pdf -a pdf-themesdir=themes -a pdf-theme=basic $^ 
	# asciidoctor-pdf -o $@ $^ $(LDFLAGS)

.PHONY: clean
clean:
	rm -f $(obj)
# Change User Description Committed
#15 31851 C. Thomas Tyler Adjusted name of the generated HTML file for The Site Directory, and updated
references to it.

Spell check on SDP Guide.
#14 31185 C. Thomas Tyler Added more detailed information on The Site Directory (/p4/common/site).

Adapted Makefile to generate HTML from Markdown for this special case
where the /p4/common/site/ReadMe.md file deployed with the SDP in a
runtime environment in the site folder generates an HTML elsewhere,
in the SDP doc folder.

Fixes SDP-722.
#13 30439 Robert Cowham Update to README and Makefile comment for rebuild
#12 30000 C. Thomas Tyler Refined Release Notes and top-level README.md file in preparation
for coming 2023.2 release.

Adjusted Makefile in doc directory to also generate top-level
README.html from top-level README.md file so that the HTML file is
reliably updated in the SDP release process.

Updated :revnumber: and :revdate: docs in AsciiDoc files to
indicate that the are still current.

Avoiding regen of ReleaseNotes.pdf binary file since that will
need at least one more update before shipping SDP 2023.2.
#11 29833 C. Thomas Tyler Added rule for generating HTML from Markdown using 'markdown' binary.
#10 29696 C. Thomas Tyler Makefile tweak.
#9 27722 C. Thomas Tyler Refinements to @27712:
* Resolved one out-of-date file (verify_sdp.sh).
* Added missing adoc file for which HTML file had a change (WorkflowEnforcementTriggers.adoc).
* Updated revdate/revnumber in *.adoc files.
* Additional content updates in Server/Unix/p4/common/etc/cron.d/ReadMe.md.
* Bumped version numbers on scripts with Version= def'n.
* Generated HTML, PDF, and doc/gen files:
  - Most HTML and all PDF are generated using Makefiles that call an AsciiDoc utility.
  - HTML for Perl scripts is generated with pod2html.
  - doc/gen/*.man.txt files are generated with .../tools/gen_script_man_pages.sh.

#review-27712
#8 27536 C. Thomas Tyler Legacy Upgrade Guide doc updates:
* Added 'Put New SDP in Place' section.
* Added 'Set SDP Counters' section to set SDP_VERSION and SDP_DATE counters.
* Covered updating depot spec Map fields.
* Covered adding server.id files.
* Added missing content on putting new SDP directory in place.

SDP_Guide.Unix doc updates:
* Added Legacy Upgrade Scripts section w/clear_depot_Map_fields.sh.

Updated Makefile with new doc build dependencies.

Regenerated docs.
#7 27398 C. Thomas Tyler Refined Makefile for generating docs and regenerated docs.
#6 27397 C. Thomas Tyler Minor tweaks to doc Makefile; added 'rec' target.
Changed toc notes to 2 levels for Release Notes.
#5 27049 C. Thomas Tyler Enhanced doc generation Makefile:
* Added new 'full' target to 'p4 sync' and generate script man pages.
* Added new 'GenerateAllScriptManPages' target.
* Added dependency on generated script man pages.
#4 27041 Robert Cowham Windows Guide directly includes chunks of the Unix guide for replication etc, with a little
ifdef to avoid Unix only comments.
Fix Makefile and add missing generated man page.
#3 26783 C. Thomas Tyler Enhanced Makefile for AsciiDocc to support building individual
targets, and also incrementally build only what's needed.
#2 26629 Robert Cowham Fixed Makefile to generate HTML
Check in theme
Some notes in README
Remove the .docx!
#1 26628 Robert Cowham Basically have things working for AsciiDoc