Go to file
chodorowski 91308d18be This is a plain-text version of license.html.
git-svn-id: https://svn.aros.org/svn/aros/trunk/AROS@9679 fb15a70f-31f2-0310-bbcc-cdcc74a49acc
2001-01-02 12:02:36 +00:00
arch Fixed compiler warning by a cast 2001-01-01 14:16:11 +00:00
compiler re- renamed the libbase members of ReqToolsBase from rt_<libbase> to 2000-12-28 18:56:39 +00:00
config Make endtag.c always generated in the $(OBJDIR) directory at least for 2000-12-21 06:33:44 +00:00
docs Fixed some URLs and email-addresses. 2001-01-01 23:00:58 +00:00
local
rom Fixed some minor bugs and typos, and implemented a couple more TagItems 2000-12-31 19:16:10 +00:00
scripts New versions supporting more platforms (like QNX Neutrino ;-) 2000-12-28 23:07:32 +00:00
test Program to test the console's RAW mode. 2001-01-01 04:11:57 +00:00
tools Use nice Makefile.aros for subdir (which uses $(TOP)/config/host.cfg) 2000-12-30 18:30:22 +00:00
workbench Removed generated files. 2001-01-01 19:35:30 +00:00
.cvsignore Began work on new debug code (see mail). Unusable right now (see also mail :-). 2000-07-16 16:06:55 +00:00
LICENSE This is a plain-text version of license.html. 2001-01-02 12:02:36 +00:00
Makefile.in build createdtdesc tool. 2000-11-07 19:52:13 +00:00
_gdbinit
aclocal.m4 First part of the build structure change. This SHOULD NOT have any adverse effects. I can only test it under FreeBSD and Linux though. If you do have any problems, fix them yourself, but tell me as well. Basically this only effects the configure and early make stages of building. 2000-02-26 13:44:46 +00:00
configure.in added option "enable-bochs-hack". Disables some things in AROS native 2000-10-15 15:27:06 +00:00
contents Updated 2000-02-12 21:30:41 +00:00
debug.opts.in Began work on new debug code (see mail). Unusable right now (see also mail :-). 2000-07-16 16:06:55 +00:00
license.html typo 2000-03-07 16:29:28 +00:00
make.defaults Added cybergfx 2000-01-02 22:10:05 +00:00
make.defaults.in add shared option for missing libraries 2000-05-18 16:00:22 +00:00
mmake.config.in changes to make AROS compile on netbsd, hope it doesn't break anything on other ports 2000-09-01 12:33:37 +00:00
mmakefile cleaned up clean target 2000-03-10 07:03:23 +00:00

docs/README.txt

Creating the HTML version of the documentation
==============================================

To create the HTML docs, you must call mmake .docs or mmake .all-docs.
The latter will query the mSQL database at the AROS site and update 
the status pages (if it doesn't, then that's what it should do). 

This is a multi-step process. First the makefile generates a list of all
source files. These are then scanned for function and library names (to
get a list of functions sorted by name and library) and converted into
an index. Then CVS is called for every source file (to get the HISTORY)
and the html page for each function is generated from the source and the
CVS log. The last step is to create one big HTML file with lots of
tables which contain a nicely formatted version of the function index.

After that, the .src files are converted into HTML, the resulting files
are copied into the HTML directory and the permissions are fixed.


What is mmake?
==============

"mmake" ist the preprocessor, ".docs" is the meta-make rule.
Just run "AROS/setup", "AROS/configure" and "mmake .docs"
But I suppose you will have some trouble, since the makefile tries to
get the history of sources via cvs (so you have to be on the net, or
disable this in the mmakefile)

mmake is a separate tool that's part of AROS. Just do

./configure
make

in the main dir and an executable mmake should be generated there.
Alternatively, change to tools/MetaMake and see there for further
instructions.



What else do I need?
====================

The files in:
-AROS/
And everything in: 
-AROS/config/
-AROS/docs/
-AROS/rom/
-AROS/tools/
-AROS/workbench/

AROS/ contains the setup files to generate some tools you may need. 
AROS/tools/ contains the tools you need to 'build' the docs.
AROS/workbench/, AROS/rom/ and AROS/config/ contain the sources 
with the docs for the AROS functions. 
AROS/docs/ contains some other docs (how to use CVS, for example)
and the scripts to build the HTML docs from the sources. You can 
update the parts you need with

    cvs update -dP config docs rom workbench tools


(This README file is largely based on e-mail from Aaron Digulla, 
Henning Kiel and Sebastian Rittau in response to questions by me, 
Branko Collin.)