3d7a6b0b50
The "make" commands and filenames below are run in/relative to the documentation directory. 1. Between releases, EPICS_DEV_SNAPSHOT != "": "make" generates $(COMMON_DIR)/RELEASE_NOTES.md from new-notes/*.md and installs it and all the older RELEASE-<ver>.md files into the $(INSTALL_DOC) directory. "make release" or "make unrelease" fail with an error message: "make release" not available, EPICS_DEV_SNAPSHOT not empty 2. Creating a release, so EPICS_DEV_SNAPSHOT == "": "make" installs all existing RELEASE-<ver>.md files into $(INSTALL_DOC). 3. Creating a release, EPICS_DEV_SNAPSHOT == "", no file exists named RELEASE-<ver>.md: "make release" generates RELEASE-<ver>.md from new-notes/*.md and does "git add" of that; runs "git rm" of new-notes/*.md; generates $(COMMON_DIR)/RELEASE_NOTES.md with a different introduction; Installs all RELEASE*.md files into $(INSTALL_DOC). 4. EPICS_DEV_SNAPSHOT == "", RELEASE-<ver>.md exists and was added to the Git index: "make unrelease" here undoes the changes the "make release" command applied to the Git index and restores the deleted new-notes files. Running "make release" twice in a row could mess up the first generated RELEASE-<ver>.md file if any new-notes/*.md files were added or the make-notes.pl script modified between the two, but to recover just running "make unrelease" and then "make release" again. 4. EPICS_DEV_SNAPSHOT == "", RELEASE-<ver>.md was added to Git but the file has since been deleted: "make unrelease" here will also recover the state and restore any deleted new-notes/*.md files. 5. EPICS_DEV_SNAPSHOT == "", RELEASE-<ver>.md exists but was not added to the Git index: "make release" or "make unrelease" fail with an error message: "make release" not available, RELEASE-<ver>.md exists but isn't in Git
--------------------------------------------------------- EPICS Base - the central core of a control system toolkit --------------------------------------------------------- Copyright UChicago Argonne LLC, as Operator of Argonne National Laboratory. Copyright (c) 1991-2003 The Regents of the University of California, as Operator of Los Alamos National Laboratory. EPICS Base is distributed subject to a Software License Agreement found in the file LICENSE that is included with this distribution. --------------------------------------------------------- Installation and release information can be found in the various files in the documentation subdirectory. Additional information about EPICS including mailing list archives and subscription instructions, documentation and training materials, additional components, links to other websites etc. is available on the EPICS home page at https://epics.anl.gov/ $Format:%cD$ $Format:%H$ https://code.launchpad.net/epics-base