Skip to content

jamoma/JamomaDoc

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
Max
 
 
 
 
 
 
 
 

#JAMOMA DOCUMENTATION REPOSITORY

This is the repository for everything documentation-related. Here are hosted various pieces of reference files, tutorials, etc. for Max implementation as well as some documentation on Jamoma API

##BUILDING THE API DOCUMENTATION W/ DOXYGEN

###QUICK INSTRUCTIONS

The API that documents our C++ source code is generated by Doxygen. A configuration file is included in this repository (Jamoma_doxyfile.txt) that can easily be used with the GUI front-end available on the Doxygen website. When it is run, it will search source files in both the Core (../Core/) and Implementations (../Implementations/) repositories for formatted comments found in individual files. These are then rendered as HTML in a new build folder (Doxygen/build/). It is STRONGLY advised that you delete this folder between attempts to render the content.

For more information on Doxygen, visit: http://www.stack.nl/~dimitri/doxygen/index.html

##WRITING DOCUMENTATION ###PREFERRED FORMAT

Max's refpages are written in yaml. There are automatically converted as xml files by the build.rb script. Use the provided template (./Tools/j.object-template.maxref.yml) to get you started.

Max's tutorials and vignette are written as Textile format as much as possible since it proves to be light, easy to maintain and can be exported in various format. A template is also provided (./Tools/TextileTemplate.textile).

###REGARDING THE USE OF BRANCHES

The 'master' branch is where all documents ready to be published are to reside. Note that all materials in the master branch are automatically converted from textile to html when building the Jamoma installer.

Thus, when starting to work on a tutorial or documentation bit, it is advised to work on the 'dev' branch or create a specific branch if needed. Once you are done with writing the documentation part, merge the branch into 'master' or use Git 'cherry-pick' command.