acpica/generate/release/build.txt
Robert Moore 0ac19a10da Build helpfile: update for new version of ACPICA website.
More instructions on how to update the website.
2013-05-24 14:34:40 -07:00

104 lines
3.7 KiB
Plaintext

Instructions to create a full release of the ACPICA software
and utilities.
Last update 24 May 2013.
The build uses MS Visual Studio and Cygwin to accomplish the
goal of releasing both Windows and Unix versions of the ACPICA code
and utilities. For Windows, binary versions of the ACPICA utilities
(including the iASL compiler) are created.
Build the ACPICA Software
-------------------------
Cleanup any extraneous files in the local git tree
Complete any updates to the ACPICA documentation (ACPICA ref, iASL ref)
Create the .PDF versions of the .DOC files
Checkin any changed documents
Update the version number (form 0xyyyymmdd) in source/include/acpixf.h
Build Windows debug versions of all software and utilities
Build Windows nodebug versions of all software and utilities
(generate/msvc9)
Build Unix versions of all software and utilities
(generate/unix/make)
Write the release notes
Generate sizes for the acpica library from generate/release/size.bat
Note: This step uses MS dumpbin(link) which is a part of the VC package.
It might not work unless the environment variables are set correctly.
Execute VC/vcvarsall.bat from the command line if necessary.
Sizes appear in the files size_rel.txt and size_dbg.txt
Integrate code/data and debug/nodebug sizes into the release notes
Add the release notes to the documents/changes.txt document
Note: From Word, use "Save As", then check MS-DOS and "insert line breaks"
boxes before saving.
Checkin documents/changes.txt
Checkin the new version number, source/include/acpixf.h
Git push everything
Tag the version file with a name of the form Rmm_dd_yy
git tag -m"version yyyymmdd" Rmm_dd_yy <commit #>
git push --tags
Build the various tar/zip release files:
Convert the generate/release/.sh files to unix format: dos2unix *.sh
On cygwin, execute generate/release/release.sh (sh release.sh)
Update ACPICA website
---------------------
Login to acpica.org (with update permission)
Goto: ContentManagement->CreateContent->Downloads
Add a new download node:
Title: Use the new version number (e.g., "Version 20130517")
Body: Insert the release notes for this version
Date: Current date
File Attachments: Attach all of the release zip/gz files (currently 6 files)
(From the generate/release/current directory)
Click "Save" at the bottom of the page
Version number headers and file pathnames:
Goto "Documentation", click edit, update version at body top, click save at bottom
Goto "Downloads", click edit, update version at body top, click save at bottom
Update paths to new file versions, update file sizes (3)
Goto "Downloads/Linux Support", click edit, update version at body top, click save at bottom
Goto "Downloads/Windows Source Code", click edit, update version at body top, click save at bottom
Update paths to new file versions, update file sizes (2)
Goto "Downloads/Windows Binary Tools", click edit, update version at body top, click save at bottom
Update paths to new file version, update file size (1)
Goto "Source", click edit, update version at body top, click save at bottom
New documents:
Goto the documents page, click edit.
Attach new document(s)
uncheck the "List" box
Update pathnames (and file sizes) in body for each new filename
(appears at bottom of each attach)
Click save at bottom
<Note: may be fixed so that the filename can stay the same>
Email the release notes
-----------------------
Send separate copies of the notes (in plain text) to the following:
AcpiCa (acpica.intel.com)
devel@acpica.org
acpi@linux.intel.com
CaClients (undisclosed recipients/BCC: list)
Update ACPICA bugzilla
----------------------
Close any problem reports that have been resolved.