-
Enhancement
-
Resolution: Fixed
-
P4
-
5.0
-
rc
-
generic
-
other
Create spec subdirectories for doclet and taglet API documentation.
This is desirable so the spec can sit in the docs/guide/javadoc/doclet (or
taglet) directory along with other example and overview files as
docs/guide/javadoc/doclet/spec. Without this change, there would
be confusion: docs/guide/javadoc/doclet/doclet/
which makes the program copy-noncore-api-to-rhea harder to write.
Changes in make/docs/Makefile are shown below
where + means add and - means remove line
docletapidocs:
@# ######## doclet api ############################
- $(RM) -r $(DOCSDIR)/tooldocs/javadoc/doclet
+ $(RM) -r $(DOCSDIR)/tooldocs/javadoc/doclet/spec
- $(MKDIR) -p $(DOCSDIR)/tooldocs/javadoc/doclet
+ $(MKDIR) -p $(DOCSDIR)/tooldocs/javadoc/doclet/spec
$(JAVADOC) $(DOCLETAPI_JAVADOCFLAGS) - -d $(DOCSDIR)/tooldocs/javadoc/doclet + -d $(DOCSDIR)/tooldocs/javadoc/doclet/spec -sourcepath $(RELEASEDOCS_SRCPATH) $(DOCLETAPI_LINKOPT) $(DOCLETAPI_PKGS)
tagletapidocs:
@# ######## taglet api ############################
- $(RM) -r $(DOCSDIR)/tooldocs/javadoc/taglet
+ $(RM) -r $(DOCSDIR)/tooldocs/javadoc/taglet/spec
- $(MKDIR) -p $(DOCSDIR)/tooldocs/javadoc/taglet
+ $(MKDIR) -p $(DOCSDIR)/tooldocs/javadoc/taglet/spec
$(RM) -r $(DOCSTMPDIR)
$(MKDIR) -p $(DOCSTMPDIR)
$(JAVADOC) $(TAGLETAPI_JAVADOCFLAGS) -d $(DOCSTMPDIR) -linkoffline ../../../api $(DOCSDIR)/api/ $(SHARE_SRC)/classes/$(TAGLETAPI_FILE)
- cp -r $(DOCSTMPDIR)/com $(DOCSDIR)/tooldocs/javadoc/taglet
+ cp -r $(DOCSTMPDIR)/com $(DOCSDIR)/tooldocs/javadoc/taglet/spec
- cp $(DOCSTMPDIR)/stylesheet.css $(DOCSDIR)/tooldocs/javadoc/taglet
+ cp $(DOCSTMPDIR)/stylesheet.css $(DOCSDIR)/tooldocs/javadoc/taglet/spec
$(RM) -r $(DOCSTMPDIR)
###@###.### 2005-05-10 01:17:30 GMT
This is desirable so the spec can sit in the docs/guide/javadoc/doclet (or
taglet) directory along with other example and overview files as
docs/guide/javadoc/doclet/spec. Without this change, there would
be confusion: docs/guide/javadoc/doclet/doclet/
which makes the program copy-noncore-api-to-rhea harder to write.
Changes in make/docs/Makefile are shown below
where + means add and - means remove line
docletapidocs:
@# ######## doclet api ############################
- $(RM) -r $(DOCSDIR)/tooldocs/javadoc/doclet
+ $(RM) -r $(DOCSDIR)/tooldocs/javadoc/doclet/spec
- $(MKDIR) -p $(DOCSDIR)/tooldocs/javadoc/doclet
+ $(MKDIR) -p $(DOCSDIR)/tooldocs/javadoc/doclet/spec
$(JAVADOC) $(DOCLETAPI_JAVADOCFLAGS) - -d $(DOCSDIR)/tooldocs/javadoc/doclet + -d $(DOCSDIR)/tooldocs/javadoc/doclet/spec -sourcepath $(RELEASEDOCS_SRCPATH) $(DOCLETAPI_LINKOPT) $(DOCLETAPI_PKGS)
tagletapidocs:
@# ######## taglet api ############################
- $(RM) -r $(DOCSDIR)/tooldocs/javadoc/taglet
+ $(RM) -r $(DOCSDIR)/tooldocs/javadoc/taglet/spec
- $(MKDIR) -p $(DOCSDIR)/tooldocs/javadoc/taglet
+ $(MKDIR) -p $(DOCSDIR)/tooldocs/javadoc/taglet/spec
$(RM) -r $(DOCSTMPDIR)
$(MKDIR) -p $(DOCSTMPDIR)
$(JAVADOC) $(TAGLETAPI_JAVADOCFLAGS) -d $(DOCSTMPDIR) -linkoffline ../../../api $(DOCSDIR)/api/ $(SHARE_SRC)/classes/$(TAGLETAPI_FILE)
- cp -r $(DOCSTMPDIR)/com $(DOCSDIR)/tooldocs/javadoc/taglet
+ cp -r $(DOCSTMPDIR)/com $(DOCSDIR)/tooldocs/javadoc/taglet/spec
- cp $(DOCSTMPDIR)/stylesheet.css $(DOCSDIR)/tooldocs/javadoc/taglet
+ cp $(DOCSTMPDIR)/stylesheet.css $(DOCSDIR)/tooldocs/javadoc/taglet/spec
$(RM) -r $(DOCSTMPDIR)
###@###.### 2005-05-10 01:17:30 GMT