Skip to content

Cheat sheets

Git

A minimum set of git commands used in the workflow for CABLE is given in the following table:

Command Description
git clone <URL> create a working copy of a remote repository
git checkout <branchname> Switch to a different branch
creates the branch if it does not exist
git add <filenames> Add files with modifications and new files to the index before committing to git
git commit Commit the index. You need to add an informative comment
git push Send your local changes to the remote repository
git pull Update your checkout branch with the state on the remote repository
git branch -d <branchname> Delete a local branch. You need to have a different branch
currently checked out

Additional commands and information can be found in this "simple guide"

FORD

For details about the configuration or more explanation of the syntax, please refer to the full documentation for FORD.

This cheat-sheet is intended for use for the documentation of the CABLE land surface model and focuses on the features needed for that purpose.

Syntax Description
!! Comment line for documentation
after the code to document
!* Block of comments for documentation
after the code to document
!> Comment line for documentation
before the code to document
!| Block of comments for documentation
before the code to document
\(...\) Inline mathematics notation
\[...\] Mathematics notation on its own line
\begin{equation}...\end{equation} Numbered equation on its own line

Markdown

For a quick reference to Markdown, please use this cheat sheet.