Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-5050861

Create "spec" subdirectories for doclet and taglet API docs in makefile

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Fixed
    • Icon: P4 P4
    • 6
    • 5.0
    • docs
    • 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

            earmstrosunw Eric Armstrong (Inactive)
            dkramersunw Douglas Kramer (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: