projects / pub / USBasp.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
Fix ring buffer example.
[pub/USBasp.git] / LUFA / StudioIntegration / makefile
diff --git a/LUFA/StudioIntegration/makefile b/LUFA/StudioIntegration/makefile
index 3227997..2649598 100644 (file)
--- a/LUFA/StudioIntegration/makefile
+++ b/LUFA/StudioIntegration/makefile
@@ -29,24 +29,26 @@ EXTENSION_OUTPUT_XML := $(LUFA_ROOT)/../extension.xml
 MODULE_OUTPUT_XML    := $(LUFA_ROOT)/asf.xml
 MSHELP_OUTPUT_XML    := $(LUFA_ROOT)/../lufa_help_$(EXT_VERSION_NUM).mshc
 XML_FILES            := $(filter-out $(TEMP_MANIFEST_FILE), $(shell ls *.xml))
 MODULE_OUTPUT_XML    := $(LUFA_ROOT)/asf.xml
 MSHELP_OUTPUT_XML    := $(LUFA_ROOT)/../lufa_help_$(EXT_VERSION_NUM).mshc
 XML_FILES            := $(filter-out $(TEMP_MANIFEST_FILE), $(shell ls *.xml))
-VSIX_ASSETS          := $(LUFA_ROOT)/DoxygenPages/Images/LUFA_thumb.png \
-                        $(LUFA_ROOT)/DoxygenPages/Images/LUFA.png       \
-                        $(LUFA_ROOT)/License.txt                        \
-                        VSIX/"[Content_Types].xml"                      \
-                        VSIX/ASFExplorer.png                            \
-                        VSIX/ASFWizard.png                              \
-                        VSIX/NewExampleWizard.png                       \
-                        VSIX/GettingStarted.htm                         \
-                        Blob/Atmel.Studio.Services.Interfaces.dll       \
-                        Blob/LUFA.dll                                   \
-                        Blob/LUFA.pkgdef
-
-MSHELP_GEN_PARAMS   := --stringparam generate.toc "book toc"            \
-                       --stringparam chunk.quietly "1"                  \
-                       --stringparam chunk.section.depth "3"            \
-                       --stringparam chunk.first.sections "1"
-
-all: generate_xml check_filenames generate_vsix
+VSIX_ASSETS          := $(LUFA_ROOT)/DoxygenPages/Images/LUFA_thumb.png     \
+                        $(LUFA_ROOT)/DoxygenPages/Images/LUFA.png           \
+                        $(LUFA_ROOT)/License.txt                            \
+                        VSIX/"[Content_Types].xml"                          \
+                        VSIX/LUFA.dll                                       \
+                        VSIX/LUFA.pkgdef
+VSIX_GEN_PARAMS     := --stringparam extension-version "$(EXT_VERSION_NUM)" \
+                       --stringparam lufa-version "$(LUFA_VERSION_NUM)"
+MSHELP_GEN_PARAMS   := --stringparam generate.toc "book toc"                \
+                       --stringparam chunk.quietly "1"                      \
+                       --stringparam chunk.section.depth "3"                \
+                       --stringparam chunk.first.sections "1"               \
+                       --stringparam chapter.autolabel "0"                  \
+                       --stringparam root.filename "LUFA"                   \
+                       --stringparam html.stylesheet "lufa_studio_help_styling.css"
+
+all: clear_project_dirs generate_xml check_filenames generate_vsix
+
+clear_project_dirs:
+       @make -s -C $(LUFA_ROOT)/.. clean
 
 clean:
        @rm -f $(TEMP_MANIFEST_XML) $(MODULE_OUTPUT_XML) $(EXTENSION_OUTPUT_XML) $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML) $(MSHELP_OUTPUT_XML)
 
 clean:
        @rm -f $(TEMP_MANIFEST_XML) $(MODULE_OUTPUT_XML) $(EXTENSION_OUTPUT_XML) $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML) $(MSHELP_OUTPUT_XML)
@@ -60,7 +62,7 @@ $(DOXYGEN_COMBINED_XML): $(DOXYGEN_TAG_FILE_XML)
        @xsltproc $(dir $@)/combine.xslt $(dir $@)/index.xml > $(DOXYGEN_COMBINED_XML)
 
 $(TEMP_MANIFEST_XML): $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML)
        @xsltproc $(dir $@)/combine.xslt $(dir $@)/index.xml > $(DOXYGEN_COMBINED_XML)
 
 $(TEMP_MANIFEST_XML): $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML)
-       @echo "Generating Manifest XML..."
+       @echo Generating temporary module manifest XML...
 
        @printf "<lufa-manifest version=\"%s\" tagfile=\"%s\" docfile=\"%s\">\n" $(LUFA_VERSION_NUM) $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML) > $@
        @for i in $(XML_FILES); do \
 
        @printf "<lufa-manifest version=\"%s\" tagfile=\"%s\" docfile=\"%s\">\n" $(LUFA_VERSION_NUM) $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML) > $@
        @for i in $(XML_FILES); do \
@@ -68,69 +70,71 @@ $(TEMP_MANIFEST_XML): $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML)
        done;
        @echo '</lufa-manifest>' >> $@
 
        done;
        @echo '</lufa-manifest>' >> $@
 
-       @echo "Manifest XML file generated."
-
 $(MODULE_OUTPUT_XML): $(TEMP_MANIFEST_XML)
 $(MODULE_OUTPUT_XML): $(TEMP_MANIFEST_XML)
-       @echo "Processing asf.xml file..."
+       @echo Generating library core XDK module manifest file...
        @xsltproc XDK/lufa_module_transform.xslt $< | xsltproc XDK/lufa_indent_transform.xslt - > $(MODULE_OUTPUT_XML)
        @xsltproc XDK/lufa_module_transform.xslt $< | xsltproc XDK/lufa_indent_transform.xslt - > $(MODULE_OUTPUT_XML)
-       @echo "Atmel Studio asf.xml file generated."
 
 $(EXTENSION_OUTPUT_XML): $(TEMP_MANIFEST_XML)
 
 $(EXTENSION_OUTPUT_XML): $(TEMP_MANIFEST_XML)
-       @echo "Processing extension.xml file..."
+       @echo Generating library XDK extension manifest file...
        @xsltproc XDK/lufa_extension_transform.xslt $< | xsltproc XDK/lufa_indent_transform.xslt - > $(EXTENSION_OUTPUT_XML)
        @xsltproc XDK/lufa_extension_transform.xslt $< | xsltproc XDK/lufa_indent_transform.xslt - > $(EXTENSION_OUTPUT_XML)
-       @echo "Atmel Studio extension.xml file generated."
 
 $(MSHELP_OUTPUT_XML): $(DOXYGEN_COMBINED_XML)
 
 $(MSHELP_OUTPUT_XML): $(DOXYGEN_COMBINED_XML)
-       @echo Converting Doxygen XML to Docbook...
+       @echo Converting Doxygen XML to DocBook...
        @-mkdir mshelp 2> /dev/null
        @-mkdir mshelp 2> /dev/null
-       @xsltproc HV1/lufa_docbook_transform.xsl $(DOXYGEN_COMBINED_XML) > mshelp/lufa_docbook.xml
-       @cd mshelp && xsltproc $(MSHELP_GEN_PARAMS) ../Docbook/mshelp/docbook.xsl lufa_docbook.xml
+       @xsltproc HV1/lufa_docbook_transform.xslt $(DOXYGEN_COMBINED_XML) > mshelp/lufa_docbook.xml
+
+       @echo Converting DocBook XML to Microsoft Help 1.0...
+       @cd mshelp && xsltproc $(MSHELP_GEN_PARAMS) ../HV1/lufa_hv1_transform.xslt lufa_docbook.xml
 
        @echo Copying help assets...
 
        @echo Copying help assets...
+       @cp HV1/lufa_studio_help_styling.css mshelp
        @-mkdir mshelp/images 2> /dev/null
        @cp `find $(LUFA_ROOT)/DoxygenPages/Images -type f` mshelp/images
 
        @echo Archiving help content...
        @-mkdir mshelp/images 2> /dev/null
        @cp `find $(LUFA_ROOT)/DoxygenPages/Images -type f` mshelp/images
 
        @echo Archiving help content...
-       @cd mshelp && zip ../$(MSHELP_OUTPUT_XML) -q -0  -r *.html images
+       @cd mshelp && zip ../$(MSHELP_OUTPUT_XML) -q -0  -r *.html *.css images
 
 
+       @echo Generating HV1 manifest...
+       @xsltproc $(VSIX_GEN_PARAMS) HV1/lufa_helpcontentsetup_transform.xslt HV1/helpcontentsetup.msha > $(LUFA_ROOT)/../helpcontentsetup.msha
+
+generate_help: $(MSHELP_OUTPUT_XML)
 
 generate_xml: $(EXTENSION_OUTPUT_XML) $(MODULE_OUTPUT_XML)
 
 generate_vsix: $(EXTENSION_OUTPUT_XML) $(MODULE_OUTPUT_XML) $(MSHELP_OUTPUT_XML)
 
 generate_xml: $(EXTENSION_OUTPUT_XML) $(MODULE_OUTPUT_XML)
 
 generate_vsix: $(EXTENSION_OUTPUT_XML) $(MODULE_OUTPUT_XML) $(MSHELP_OUTPUT_XML)
-       @echo "Generating ASF cache files..."
+       @echo Generating XDK cache files...
        @rm -f $(LUFA_ROOT)/../content.xml.cache
        @rm -f $(LUFA_ROOT)/../ExampleProjects.xml
        @python VSIX/generate_caches.py $(LUFA_ROOT)/../
 
        @rm -f $(LUFA_ROOT)/../content.xml.cache
        @rm -f $(LUFA_ROOT)/../ExampleProjects.xml
        @python VSIX/generate_caches.py $(LUFA_ROOT)/../
 
-       @echo "Archiving ASF content..."
+       @echo Archiving XDK content...
        @rm -f contents.zip
        @cd $(LUFA_ROOT)/../ && zip contents.zip -q -0 -r --exclude=*Documentation* --exclude=*StudioIntegration* LUFA Bootloaders Demos Projects README.txt
 
        @rm -f contents.zip
        @cd $(LUFA_ROOT)/../ && zip contents.zip -q -0 -r --exclude=*Documentation* --exclude=*StudioIntegration* LUFA Bootloaders Demos Projects README.txt
 
-       @echo "Creating VSIX dependencies..."
+       @echo Creating VSIX dependencies...
        @cp $(VSIX_ASSETS) $(LUFA_ROOT)/..
        @cp $(VSIX_ASSETS) $(LUFA_ROOT)/..
-       @xsltproc --stringparam extension-version "$(EXT_VERSION_NUM)" VSIX/lufa_vsmanifest_transform.xslt VSIX/extension.vsixmanifest > $(LUFA_ROOT)/../extension.vsixmanifest
-       @xsltproc --stringparam lufa-version "$(LUFA_VERSION_NUM)" VSIX/lufa_asfmanifest_transform.xslt VSIX/asf-manifest.xml > $(LUFA_ROOT)/../asf-manifest.xml
-       @xsltproc --stringparam extension-version "$(EXT_VERSION_NUM)" HV1/lufa_helpcontentsetup_transform.xslt HV1/helpcontentsetup.msha > $(LUFA_ROOT)/../helpcontentsetup.msha
+       @xsltproc $(VSIX_GEN_PARAMS) VSIX/lufa_vsmanifest_transform.xslt VSIX/extension.vsixmanifest > $(LUFA_ROOT)/../extension.vsixmanifest
+       @xsltproc $(VSIX_GEN_PARAMS) VSIX/lufa_asfmanifest_transform.xslt VSIX/asf-manifest.xml > $(LUFA_ROOT)/../asf-manifest.xml
 
 
-       @echo "Generating Atmel Studio VSIX file..."
+       @echo Generating Atmel Studio VSIX file...
        cd $(LUFA_ROOT)/../ && zip $(EXT_VSIX_NAME) -q -9 contents.zip exampleProjects.xml content.xml.cache extension.vsixmanifest asf-manifest.xml extension.xml helpcontentsetup.msha $(notdir $(MSHELP_OUTPUT_XML)) $(notdir $(VSIX_ASSETS))
        cd $(LUFA_ROOT)/../ && zip $(EXT_VSIX_NAME) -q -9 contents.zip exampleProjects.xml content.xml.cache extension.vsixmanifest asf-manifest.xml extension.xml helpcontentsetup.msha $(notdir $(MSHELP_OUTPUT_XML)) $(notdir $(VSIX_ASSETS))
-       @echo "Atmel Studio VSIX Extension file generated."
+
+       @echo "Atmel Studio VSIX extension file generated."
 
 check_filenames: $(MODULE_OUTPUT_XML)
 
 check_filenames: $(MODULE_OUTPUT_XML)
-       @echo Verifying referenced filenames of ASF.xml modules...
+       @echo Verifying referenced filenames of XDK modules...
        @for f in `find $(LUFA_ROOT)/../ -name "asf.xml"`; do \
                echo "Checking $$f..."; \
                asf_file_dir=`dirname $$f`; \
                xsltproc XDK/lufa_filelist_transform.xslt $$f | sed -e "/^$$/d" | while read -r i; do \
        @for f in `find $(LUFA_ROOT)/../ -name "asf.xml"`; do \
                echo "Checking $$f..."; \
                asf_file_dir=`dirname $$f`; \
                xsltproc XDK/lufa_filelist_transform.xslt $$f | sed -e "/^$$/d" | while read -r i; do \
-                       if ( ! test -f "$$asf_file_dir/$$i" ); then \
+                       if ( ( ! test -f "$$asf_file_dir/$$i" ) && ( ! test -d "$$asf_file_dir/$$i" ) ); then \
                                echo "Source file \"$$i\" referenced in $$f does not exist!"; \
                                exit 1; \
                        fi; \
                done || exit 1; \
        done;
                                echo "Source file \"$$i\" referenced in $$f does not exist!"; \
                                exit 1; \
                        fi; \
                done || exit 1; \
        done;
-       @echo Verified referenced filenames of ASF.xml modules.
 
 
-sanity_check:
+check_database:
        python ProjectGenerator/project_generator.py -b $(LUFA_ROOT)/../ --main-ext-uuid=0e160d5c-e331-48d9-850b-e0387912171b CHECK
 
        python ProjectGenerator/project_generator.py -b $(LUFA_ROOT)/../ --main-ext-uuid=0e160d5c-e331-48d9-850b-e0387912171b CHECK
 
-.PHONY: all clean generate_xml generate_vsix check_filenames sanity_check
+.PHONY: all clean generate_help generate_xml generate_vsix check_filenames check_database
USB isp AVR programmer