[docs] Fixes to the core documentation

docs/core.tex

@@ -1,37 +1,45 @@
 % Documentation core for ToAruOS
 % Copyright 2011 Kevin Lange
-\documentclass{article}
 
+% Standard article with (centered) title page
+\documentclass[titlepage]{article}
 % Switch to a nice sans-serif font.
 \renewcommand*\familydefault{\sfdefault}
-\usepackage[margin=1in]{geometry}
+\usepackage[margin=1in]{geometry}   % Margins
-\usepackage{fancyhdr}
+\usepackage{fancyhdr}               % Fancy page header
-\usepackage{amsmath}
+\usepackage{amsmath}                % Extra mathemtics stuff
-\usepackage{listings}
+\usepackage{listings}               % Source code styling
-\usepackage{graphicx}
+\usepackage{graphicx}               % Graphics support
-\usepackage[overlap, CJK]{ruby}
+\usepackage[overlap, CJK]{ruby}     % For Japanese
-\usepackage{makeidx}
+\usepackage{makeidx}                % Indexing
-\usepackage[bookmarks]{hyperref}
+\usepackage[bookmarks]{hyperref}    % PDF hyperlink index
 
-\def\Title{ToAruOS Kernel Documentation}
+% Some useful macros for the documentation
-\def\Author{Kevin Lange}
+\newcommand{\toarutitle}{ToAruOS Kernel Documentation}
+\newcommand{\toaruversi}{v 0.0.1}
+\newcommand{\toaruautho}{Kevin Lange}
 
+% Title / Author
+\def\Title{\toarutitle}
+\title{\toarutitle}
+\def\Author{\toaruautho}
+\author{\toaruautho}
+
+% Enable indexing
 \makeindex
 
 % Some nice headers for the core contents.
 \pagestyle{fancy}
-\lhead{ToAruOS Documentation}
+\lhead{\toarutitle}
-\rhead{v0.0.1}
+\rhead{\toaruversi}
 
+% Begin document contents
 \begin{document}
 \begin{CJK}{UTF8}{goth}
 
 % Title page for documentation
 \begin{titlepage}
-\title{ToAruOS Kernel Documentation}
-\author{Kevin Lange}
 \maketitle
-
 % Make sure we don't have a number here...
 \thispagestyle{empty}
 \end{titlepage}
@@ -62,9 +70,10 @@
 \addcontentsline{toc}{section}{Index}
 \printindex
 
+% License information
 \clearpage
 \input{license.tex}
 
-
+% Fin
 \end{CJK}
 \end{document}