# rules.unix - host specific rules
#
# Copyright 1984-2004, Wind River Systems, Inc.
#
# modification history
# --------------------
# 02v,17may05,lll  Replaced malfunctioning "\n"'s with echo ""
# 02u,25apr05,kkz  Updating for new doc path
# 02t,10jan05,lll  Standalone apigen, SPR#105634 and SPR#104090
# 02s,06oct04,tpw  Switch BSP doc build forward to apigen.
# 02r,10aug04,dgp  temporarily revert BSP doc build back to refgen
# 02q,07jul04,c_c  Removed usage of romfs_image.h.
# 02p,27may04,dgp  update BSP output and TOC directories
# 02o,25may04,tpw  Switch on -missingok to reduce doc build error output.
# 02n,11feb04,c_c  Added a NODEPENDOBJS list to filter files that should not
#                  be parsed when generating dependencies (SPR 93380).
# 02m,12jan04,bjl  changed refgen to apigen.
# 02l,10dec03,c_c  fixed builds for BSP templates.
# 02k,28nov03,c_c  Reinstated variable replacement.
# 02j,26nov03,c_c  Fixed Linux simulator build.
# 02i,07nov03,c_c  Unified build rules with WIN32 hosts.
# 02h,02jul03,md   Added command (mkromfs) for building ROMFS image
# 02g,12mar02,wsl  change BSP_Reference to VxWorks_BSP_Reference
# 02f,27nov01,wsl  allow target.ref files but keep target.nr backward
#                  compatibility
# 02e,29oct01,jab  removed ld script rules
# 02d,25oct01,dat  more gnu-diab changes
# 02c,18oct01,jab  made dependency generation toolchain independent
# 02b,01oct01,dat  consistent use of BSP_NAME macro
# 02a,27aug01,wsl  add man pages
# 01z,24jul01,r_s  diab specific rules added
# 01y,28jun00,jab  force creation of LECFs.
# 01x,17feb00,jab  added LECF generation rules. See notes at rules.
# 01w,02feb99,sjw  use -M -MG in dependency generation so generated files
#		   can be included in BSP files.
# 01v,26oct98,ms   made dependency generation overridable from make.CPUTOOL
# 01u,15oct98,fle  doc : renamed book for BSP and put boards reference into
#                  board library
# 01t,05oct98,ms   remove romInit.s dependeny generation for simulators
# 01s,23sep98,fle  doc : adapted -preproc refgen new option
# 01r,23sep98,fle  doc : changed bsp book name
# 01r,22sep98,fle  doc : now use refgen instead of mangen
# 01q,02jan97,dat  added DOC_FLAGS
# 01p,21nov96,p_m  removed unwanted @ in bsp.1 rule
# 01o,21nov96,p_m  changed bsp.1 mode prior to copy target.nr
# 01n,19nov96,dat  mangen error output not dropped.  target.txt made in
#		   bsp directory. SPRs 7507 and 7508.
# 01m,15oct96,yp   made rule for include of dependency list silent SPR 4483
# 01l,03oct96,dbt  added backslashes in the sed expressions (HPUX10 port).
# 01k,30jul96,pad  undo change 01j, introduced here by mistake.
# 01j,26jul96,pad  backslashed the $ in the sed expressions (AIX port).
# 01i,10may96,dat  added -DINCLUDE_SCSI for man pages (SPR3941) added copyright
# 01h,18mar96,dat  fixed cpp command for building man pages
# 01g,06mar96,dat  added sed command to insert $TGT_DIR into depend output
# 01f,08feb96,dat  used CONFIG_ALL in making dependency list
# 01e,04nov95,p_m  took care of missing files in docs rule
# 01d,06jul95,jcf  made sed script global.
# 01c,21jun95,yp   added sed script to prevent hardwiring depend. list.
# 01b,10jun95,yp   changed TARGET_DIR to BSP_NAME
# 01a,01jun95,yp   created
#
# DESCRIPTION
# This file contains rules that are host specific to the unix platform.

## documentation build targets

DOC_FILES := $(filter $(DOC_FILES),$(patsubst %.c,%,$(wildcard *.c)))

.PHONY: $(DOC_FILES) htmllink

man	: target.html docs

docs: $(DOC_FILES) htmllink

$(DOC_FILES):
	@echo ""; echo "Processing $@.c ... "
	@-$(CPP) $(CASFLAGS) $(OPTION_PP_COMMENT) $(DOC_FLAGS) $@.c 1> $@.i
	-$(WIND_BASE)/host/$(WIND_HOST_TYPE)/bin/apigen -mg -nostrict \
	    -book VxWorks_APIs -chapter BSP_APIs \
	    -category $(BSP_NAME) -missingok \
	    -out $(DOC_DIR)/$(BSP_NAME) $@.i
	-$(WIND_BASE)/host/$(WIND_HOST_TYPE)/bin/apigen -mg -nostrict \
	    -book VxWorks_APIs -chapter BSP_APIs \
	    -category $(BSP_NAME) -missingok -config Auto2txt \
	    -out $(MAN_PAGE_DIR)/$(BSP_NAME) $@.i
	@-$(RM) $@.i

htmllink:
	@echo ""; echo "HTML linking ... "
	-$(WIND_BASE)/host/$(WIND_HOST_TYPE)/bin/htmlLink \
	    $(DOC_DIR)/$(BSP_NAME)
	@echo "Linking complete."
	@date


# The following variable assignment selects target.ref over target.nr, and
# exists only to facilitate the transition from nroff markup to refgen
# markup.  When target.nr joins its dinosaur brethren, this should be removed.

TARGET_REF = target.ref
ifeq (,$(wildcard target.ref))
  TARGET_REF = target.nr
endif

target.html:
	@echo ""; echo "Processing $(TARGET_REF) ... "
	-$(WIND_BASE)/host/$(WIND_HOST_TYPE)/bin/apigen -mg -nostrict \
	    -config bsp2html -book VxWorks_APIs -chapter BSP_APIs -missingok \
	    -out $(DOC_DIR)/$(BSP_NAME) $(TARGET_REF)
	-$(WIND_BASE)/host/$(WIND_HOST_TYPE)/bin/apigen -mg -nostrict \
	    -config bsp2txt -book VxWorks_APIs -chapter BSP_APIs -missingok \
	    -out $(MAN_PAGE_DIR)/$(BSP_NAME) $(TARGET_REF)


#
# It is possible to generate dependency lists automatically by depending on 
# a make include file:
#
#     with: 		GNU make, SunOS 4.x/5.x make.
#     but not with: 	clearmake, HPUX 9.x make, and probably plenty of others.
#
# If depend.$(BSP_NAME) has been removed and you are haplessly without
# a copy of GNU make:
#
#	% # In the BSP in question...
#	% touch depend.$(BSP_NAME)
#	% make depend.$(BSP_NAME)
#	% make
#
# Order in the Universe should be restored.
#

depend.$(BSP_NAME) :
	- $(CC) $(OPTION_DEPEND_C) $(CFLAGS) $(filter-out $(NODEPENDOBJS),$(wildcard *.[c] $(CONFIG_ALL)/*.[c])) > $@
# The two files below may not be present for simulators. So ignore the error
# returned by the compiler if the file does not exist.

ifneq ($(wildcard romInit.s),)
	$(CPP) $(OPTION_DEPEND_AS) $(CASFLAGS) romInit.s >> $@
endif
ifneq ($(wildcard sysALib.s),)
	$(CPP) $(OPTION_DEPEND_AS) $(CASFLAGS) sysALib.s >> $@
endif

# Post process the dependencies to substitute WIND variables

	- @ $(BSP_PROCESS_DEP)

# XXX generic rule for assembly files forthcoming

ifneq ($(IS_PRJ),TRUE)

BSP2PRJ=FALSE
ifeq ($(BSP2PRJ),FALSE)
ifneq ($(MAKECMDGOALS),clean) 
-include depend.$(BSP_NAME)
endif
endif

endif