blob: cae072d18ff1e03d7ff6de91024ca201e33bbb7a [file] [log] [blame]
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% __________ __ ___.
% Open \______ \ ____ ____ | | _\_ |__ _______ ___
% Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
% Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
% Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
% \/ \/ \/ \/ \/
% - M A N U A L -
%
% $Id$
%
% Copyright (C) 2006 The Rockbox Manual Team
%
% All files in this archive are subject to the GNU Free Documentation License
% See the file COPYING-MANUAL in the source tree docs/ directory for full license
% agreement.
%
% Contributors are listed in the file docs/CREDITS-MANUAL
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\documentclass[a4paper,11pt]{scrreprt}
\usepackage[utf8x]{inputenc}
\usepackage{palatino}
\usepackage{tabularx}
\usepackage{multirow}
\usepackage{multicol}
\usepackage{float}
\floatstyle{ruled}
\usepackage{hyperref}
\usepackage{enumitem}
\usepackage{optional}
\input{platform/\platform.tex}
\input{features.tex}
\newcommand{\playername}{\playerman\ \playerlongtype}
\hypersetup{% add some values to the pdf properties
colorlinks = true,
pdfstartview = FitV,
linkcolor = blue,
citecolor = blue,
urlcolor = blue,
pdftitle = {Rockbox user manual},
pdfauthor = {The Rockbox Team},
pdfsubject = {Rockbox user manual for \playername}
}
\newcommand{\fname}[1]{\texttt{#1}}
\newcommand{\tabeltc}[1]{{\centering #1 \par}}
\newcommand{\tabelth}[1]{{\centering \textbf{\textit{#1}} \par}}
\newcommand{\fixme}[1]{\textbf{\textcolor{red}{#1}}}
\usepackage{fancyhdr}
\usepackage{graphicx}
\usepackage{verbatim}
\usepackage{makeidx}
\usepackage{fancyvrb}
\usepackage{enumerate}
\usepackage{color}
\ifpdfoutput{\usepackage{booktabs}}%
{\newcommand{%
\toprule}{}\newcommand{\midrule}{\hline}\newcommand{\bottomrule}{}%
}
\usepackage{longtable}
\usepackage{url}
\urlstyle{sf}
\usepackage{marvosym}
\usepackage{ifthen}
\usepackage{rotating}
% mark this ad draft version (only for pdflatex) -- comment this out at release
\ifpdfoutput{
\usepackage{pdfdraftcopy}
\draftstring{DRAFT VERSION}
% \draftangle{45}
}
% pdf output: try pdf first, then png and jpg as file format
% html output: try png first, then jpg. Ignore pdf files
% this only applies if no file extension is given!
\ifpdfoutput{\DeclareGraphicsExtensions{.pdf,.png,.jpg}}%
{\DeclareGraphicsExtensions{.png,.jpg}}
% fancy header style adjustments
\fancyhead{}
\fancyfoot{}
\fancyhead[L]{{\nouppercase{\textsc{\leftmark}}}}
\fancyhead[R]{\iffloatpage{}{\thepage}}
\fancyfoot[L]{\textsc{The Rockbox manual}}
\fancyfoot[R]{\textsc{\playerman{} \playertype}}
\fancypagestyle{plain}{}
\renewcommand{\headrulewidth}{\iffloatpage{0pt}{0.4pt}}
\renewcommand{\footrulewidth}{\iffloatpage{0pt}{0.4pt}}
\setlength{\headheight}{18.5pt}
\newcounter{example}[chapter]
%% \newenvironment{example}
%% {\stepcounter{example}\paragraph{Example \theexample:}}
%% {\hfill$\Box$
%% \bigskip
%% \noindent}
% found on the internet, posting by Donald Arseneau
% I may as well include my robust expandable definions, which can be
% used in \edef or \write where the \def would not be executed:
%
% \if\blank --- checks if parameter is blank (Spaces count as blank)
% \if\given --- checks if parameter is not blank: like \if\blank{#1}\else
% \if\nil --- checks if parameter is null (spaces are NOT null)
% use \if\given{ } ... \else ... \fi etc.
%
{\catcode`\!=8 % funny catcode so ! will be a delimiter
\catcode`\Q=3 % funny catcode so Q will be a delimiter
\long\gdef\given#1{88\fi\Ifbl@nk#1QQQ\empty!}
\long\gdef\blank#1{88\fi\Ifbl@nk#1QQ..!}% if null or spaces
\long\gdef\nil#1{\IfN@Ught#1* {#1}!}% if null
\long\gdef\IfN@Ught#1 #2!{\blank{#2}}
\long\gdef\Ifbl@nk#1#2Q#3!{\ifx#3}% same as above
}
% environment for setting the changelog.
\newenvironment{changelog}%
{\renewcommand{\labelitemi}{$\star$}\setitemize{noitemsep,topsep=0pt}%
\begin{itemize}}%
{\end{itemize}}
% add screenshot image.
% Usage: \screenshot{filename}{caption}{label}
% By using the 'H' (HERE) placement, the screenshots are placed where
% we want them.
% Note: use this only for screenshots!
% Note: leave caption empty to supress it.
\newcommand{\screenshot}[3]{
\begin{figure}[H]
\begin{center}
\IfFileExists{#1-\genericimg-\specimg.png}
{\includegraphics[width=\screenshotsize]{#1-\genericimg-\specimg.png}
\typeout{Note: device specific image used}}
{\IfFileExists{#1-\genericimg.png}
{\includegraphics[width=\screenshotsize]{#1-\genericimg.png}}
{\IfFileExists{#1}
{\includegraphics[width=\screenshotsize]{#1}
\typeout{Warning: deprecated plain image name used}}%
{\typeout{Missing image: #1 (\genericimg) (\specimg)}%
\color{red}{\textbf{WARNING!} Image not found}%
}
}
}
\if\blank{#3}\else{\label{#3}}\fi\if\blank{#2}\else{%
\caption{#2}}\fi
\end{center}
\end{figure}
}
% command to display a note.
% Usage: \note{text of your note}
% Note: do NOT use \textbf or similar to emphasize text, use \emph!
\ifpdfoutput{
\newcommand{\note}[1]{
\ifinner\else\par\noindent\fi
\textbf{Note:}\ %
\ifinner#1\else\marginpar{\raisebox{-6pt}{\Huge\Writinghand}}#1\par\fi%
}}
{\newcommand{\note}[1]{\ifinner\else\par\noindent\fi\textbf{Note:{} }#1\par}}
% command to display a warning.
% Usage: \warn{text of your warning}
% Note: do NOT use \textbf or similar to emphasize text!
\ifpdfoutput{
\newcommand{\warn}[1]{
\ifinner\else\par\noindent\fi
\textbf{Warning:\ }%
\ifinner#1\else\marginpar{\raisebox{-6pt}{\Huge\Stopsign}}#1\par\fi%
}}
{\newcommand{\warn}[1]{\ifinner\else\par\noindent\fi\textbf{Warning:{} }#1}}
% command to mark a text block as intended especially for blind people
% Usage: \blind{text}
\ifpdfoutput{
\newcommand{\blind}[1]{
\ifinner\else\par\noindent\fi
\ifinner#1\else\marginpar{\raisebox{-6pt}{\Huge\ForwardToEnd}}#1\par\fi%
}}
{\newcommand{\blind}[1]{\ifinner\else\par\noindent\fi#1}}
% make table floats use "H" (as for screenshots) as default positioning
\makeatletter\renewcommand{\fps@table}{H}\makeatother
% change defaults for floats on a page as we have a lot of small images
\setcounter{topnumber}{3} % default: 2
\setcounter{bottomnumber}{2} % default: 1
\setcounter{totalnumber}{5} % default: 3
% command to set the default table heading for button lists
\newcommand{\btnhead}{\textbf{Key} & \textbf{Action} \\\midrule}
% environment intended to be used with button maps
% usage: \begin{btnmap}{caption}{label} Button & ButtonAction \\ \end{btnmap}
% Note: this automatically sets the table lines.
% Note: you *need* to terminate the last line with a linebreak \\
% Note: you still need to enclose this with \begin{table} / \end{table}
% Cheers for the usenet helping me building this up :)
\newenvironment{btnmap}[2]{%
\expandafter\let\expandafter\SavedEndTab\csname endtabular*\endcsname
\expandafter\renewcommand\expandafter*\csname endtabular*\endcsname{%
\bottomrule
\SavedEndTab%
\if\given{#1}\caption{#1}\fi%
\if\given{#2}\label{#2}\fi%
\endcenter%
}
\center
\tabularx{.75\textwidth}{>{\raggedright\arraybackslash}p{.22\textwidth}X}\toprule % here is the table width defined
\btnhead
}{%
\endtabularx
}
% command to set the default table heading for button lists
\newcommand{\taghead}{\textbf{Tag} & \textbf{Description} \\\midrule}
% environment intended to be used with tag maps (for wps)
% usage: \begin{tagmap}{caption}{label} Tag & Description \\ \end{btnmap}
% Note: this automatically sets the table lines.
% Note: you *need* to terminate the last line with a linebreak \\
% Note: you still need to enclose this with \begin{table} / \end{table}
% Cheers for the usenet helping me building this up :)
\newenvironment{tagmap}[2]{%
\expandafter\let\expandafter\SavedEndTab\csname endtabular*\endcsname
\expandafter\renewcommand\expandafter*\csname endtabular*\endcsname{%
\bottomrule
\SavedEndTab%
\if\given{#1}\caption{#1}\fi%
\if\given{#2}\label{#2}\fi%
\endcenter%
}
\center
\tabularx{\textwidth}{lX}\toprule % here is the table width defined
\taghead
}{%
\endtabularx
}
\newcommand{\setting}[1]{\textsc{#1}}
\newcommand{\config}[1]{\texttt{#1}}
% set link to download server
% Usage: \download{bootloader/bootloader-ipodnano.ipod}
% gets expanded to
% "http://download.rockbox.org/bootloader/bootloader-ipodnano.ipod"
\newcommand{\download}[1]{\url{http://download.rockbox.org/#1}}
% set link to the wiki.
% Usage: \wikilink{WebHome}
% with "WebHome" being the wiki page name
\newcommand{\wikibaseurl}{http://www.rockbox.org/wiki/}
\ifpdfoutput{\newcommand{\wikiicon}{\Pointinghand}}
{\newcommand{\wikiicon}{}}
\newcommand{\wikilink}[1]{\wikiicon{}\href{\wikibaseurl#1}{#1}}
%\newcommand{\wikilink}[1]{\url{http://www.rockbox.org/wiki/#1}}
% define environment "code" based on fancyvrb.
% use it to set code the user should type / see on his screen.
% Note: the first 4 characters of each line will be stripped,
% requiring everything to be indendet by exactly _4_ spaces!
% This is intended to make the LaTeX sources more readable.
% Note: when using the code environment you need to use optv instead of opt!
\DefineVerbatimEnvironment{code}{Verbatim}%
{framerule=0.4pt, framesep=1ex,frame=lines,%numbers=left,stepnumber=5,%
gobble=4,fontsize=\footnotesize,xleftmargin=10pt,xrightmargin=10pt,%
label=\textnormal{\textsc{Code}},%
commandchars=\\\{\}%
}
% define environment "example" based on fancyvrb.
% use it to set example code the user should type / see on his screen.
% Note: the first 4 characters of each line will be stripped,
% requiring everything to be indendet by exactly _4_ spaces!
% This is intended to make the LaTeX sources more readable.
% Note: when using the example environment you need to use optv instead of opt!
\DefineVerbatimEnvironment{example}{Verbatim}%
{commentchar=!,framerule=0.4pt, framesep=1ex,frame=lines,%
gobble=4,fontsize=\footnotesize,xleftmargin=10pt,xrightmargin=10pt,%
label=\textnormal{\textsc{Example}},%
commandchars=\\\{\}%
}
% Use the nopt command to exclude a certain defined feature from a sectio
% Example:
% \nopt{ondio}{This text will be excluded for ondios}
\newcommand{\optnvalue}{0}
\newcommand{\nopt}[2]{%
\renewcommand{\optnvalue}{0}\opt{#1}{\renewcommand{\optnvalue}{1}}%
\ifthenelse{\optnvalue > 0}{}{#2}%
}
% Use the reference to handle get a flexible reference command
% usage \reference{ref_section}
\ifpdfoutput{%
\newcommand{\reference}[1]{%
section~\ref{#1} (page~\pageref{#1})%
}}
{\newcommand{\reference}[1]{section~\ref{#1}}}
% special HTML output adjustments
\ifpdfoutput{}{\setlength{\parindent}{0mm}}
\ifpdfoutput{}{\renewcommand{\Forward}[1]{$\triangleright${}#1}}
\newcommand{\btnfnt}[1]{\textbf{#1}}
%\hfuzz=2pt
% generate index
\usepackage{makeidx}
\makeindex