doc: Adjust various scripts accordingly

Signed-off-by: Geoffroy Van Cutsem <geoffroy.vancutsem@intel.com>
Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
Geoffroy Van Cutsem 2018-05-15 18:02:07 +08:00 committed by Jack Ren
parent 60c07fba51
commit 12fb4b0584
9 changed files with 20 additions and 57 deletions

View File

@ -16,26 +16,19 @@ BUILDDIR = _build
DOC_TAG ?= development DOC_TAG ?= development
RELEASE ?= latest RELEASE ?= latest
PUBLISHDIR = ../projectacrn.github.io/$(RELEASE) PUBLISHDIR = ../../projectacrn.github.io/$(RELEASE)
# Put it first so that "make" without argument is like "make help". # Put it first so that "make" without argument is like "make help".
help: help:
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
@echo "" @echo ""
@echo "make pullsource"
@echo " fetch and merge upstream source for the project ACRN code repos"
@echo ""
@echo "make publish" @echo "make publish"
@echo " publish generated html to projectacrn.github.io site:" @echo " publish generated html to projectacrn.github.io site:"
@echo " specify RELEASE=name to publish as a tagged release version" @echo " specify RELEASE=name to publish as a tagged release version"
@echo " and placed in a version subfolder" @echo " and placed in a version subfolder. Requires repo merge permission."
.PHONY: help Makefile .PHONY: help Makefile
pullsource:
$(Q)scripts/pullsource.sh
# Generate the doxygen xml (for Sphinx) and copy the doxygen html to the # Generate the doxygen xml (for Sphinx) and copy the doxygen html to the
# api folder for publishing along with the Sphinx-generated API docs. # api folder for publishing along with the Sphinx-generated API docs.

View File

@ -791,10 +791,10 @@ WARN_LOGFILE =
# Note: If this tag is empty the current directory is searched. # Note: If this tag is empty the current directory is searched.
INPUT = custom-doxygen/mainpage.md \ INPUT = custom-doxygen/mainpage.md \
../acrn-hypervisor/include/common/hypercall.h \ ../hypervisor/include/common/hypercall.h \
../acrn-hypervisor/include/public/acrn_common.h \ ../hypervisor/include/public/acrn_common.h \
../acrn-hypervisor/include/public/acrn_hv_defs.h \ ../hypervisor/include/public/acrn_hv_defs.h \
../acrn-devicemodel/include/virtio.h ../devicemodel/include/virtio.h
# This tag can be used to specify the character encoding of the source files # This tag can be used to specify the character encoding of the source files

View File

@ -63,7 +63,7 @@ try:
version_major = None version_major = None
version_minor = None version_minor = None
version_rc = None version_rc = None
for line in open(os.path.normpath("../acrn-hypervisor/Makefile")) : for line in open(os.path.normpath("../hypervisor/Makefile")) :
# remove comments # remove comments
line = line.split('#', 1)[0] line = line.split('#', 1)[0]
line = line.rstrip() line = line.rstrip()
@ -93,7 +93,7 @@ finally:
# #
# The short X.Y version. # The short X.Y version.
# version = u'0.1' # version = u'0.1'
# The full version, including alpha/doc/beta/doc/rc tags. # The full version, including alpha/beta/rc tags.
# release = u'0.1' # release = u'0.1'
# The language for content autogenerated by Sphinx. Refer to documentation # The language for content autogenerated by Sphinx. Refer to documentation

View File

@ -270,7 +270,7 @@ Set up Reference UOS
# losetup -f -P --show /root/clear-22140-kvm.img # losetup -f -P --show /root/clear-22140-kvm.img
# mount /dev/loop0p3 /mnt # mount /dev/loop0p3 /mnt
# cp -r /usr/lib/doc/modules/4.14.34-28.pk414-standard /mnt/lib/doc/modules/ # cp -r /usr/lib/modules/4.14.34-28.pk414-standard /mnt/lib/modules/
# umount /mnt # umount /mnt
# sync # sync
@ -293,7 +293,7 @@ Set up Reference UOS
and version number highlighted above (the ``-s 3,virtio-blk`` argument) to match and version number highlighted above (the ``-s 3,virtio-blk`` argument) to match
what you have downloaded above. Likewise, you may need to adjust the kernel file what you have downloaded above. Likewise, you may need to adjust the kernel file
name on the second line highlighted (check the exact name to be used using: name on the second line highlighted (check the exact name to be used using:
``ls /usr/lib/doc/kernel/org.clearlinux*-standard*``). ``ls /usr/lib/kernel/org.clearlinux*-standard*``).
By default, the script is located in the ``/usr/share/acrn/demo/`` By default, the script is located in the ``/usr/share/acrn/demo/``
directory. You can edit it there, and then run it to launch the User OS: directory. You can edit it there, and then run it to launch the User OS:
@ -340,7 +340,7 @@ each with their own way to install development tools:
libpciaccess-dev \ libpciaccess-dev \
uuid-dev uuid-dev
* On a Fedora/doc/Redhat development system: * On a Fedora/Redhat development system:
.. code-block:: console .. code-block:: console

View File

@ -1,6 +1,6 @@
.. _wip: .. _wip:
Work in Progress Work in Progress
################ ################
This is a placeholder doc for technical how-to articles in-progress. This is a placeholder doc for technical how-to articles in-progress.

View File

@ -13,7 +13,7 @@ Source code for Project ACRN is maintained in the
license. license.
.. _BSD 3-clause license: .. _BSD 3-clause license:
https://github.com/projectacrn/acrn-hypervisor/blob/doc/master/LICENSE https://github.com/projectacrn/acrn-hypervisor/blob/master/LICENSE
.. _Project ACRN GitHub repo: https://github.com/projectacrn .. _Project ACRN GitHub repo: https://github.com/projectacrn

View File

@ -53,7 +53,7 @@ ACRN hypervisor source tree
include files for all public APIs (doxygen comments in these source include files for all public APIs (doxygen comments in these source
files are used to generate the :ref:`acrn_apis` documentation) files are used to generate the :ref:`acrn_apis` documentation)
**lib/doc/** **lib/**
runtime service libraries runtime service libraries
ACRN Device Model source tree ACRN Device Model source tree

View File

@ -1,30 +0,0 @@
#!/bin/bash
q="--quiet"
# pull fresh copies of the ACRN source for use by doxygen
if [ ! -d "../acrn-hypervisor" ]; then
echo Repo for acrn-hypervisor is missing.
exit -1
fi
if [ ! -d "../acrn-devicemodel" ]; then
echo Repo for acrn-devicemodel is missing.
exit -1
fi
# Assumes origin (personal) and upstream (project) remote repos are
# setup
cd ../acrn-hypervisor
git checkout $q master;
git fetch $q upstream
git merge $q upstream/master
git push $q origin master
cd ../acrn-devicemodel
git checkout $q master;
git fetch $q upstream
git merge $q upstream/master
git push $q origin master

File diff suppressed because one or more lines are too long