From 26c6e7bff9a742e53a87cc63972feae14fee455b Mon Sep 17 00:00:00 2001 From: Martin Arver Date: Tue, 1 Aug 2006 11:57:38 +0000 Subject: [PATCH] rename the rockref macro to reference git-svn-id: svn://svn.rockbox.org/rockbox/trunk@10392 a1c6a512-1295-4272-9138-f99709370657 --- manual/appendix/appendix.tex | 2 +- manual/configure_rockbox/display_options.tex | 8 +++---- manual/configure_rockbox/file_view.tex | 8 +++---- manual/configure_rockbox/language.tex | 2 +- manual/getting_started/main.tex | 6 ++--- manual/main_menu/fmradio.tex | 2 +- manual/main_menu/main.tex | 24 ++++++++++---------- manual/main_menu/recording.tex | 2 +- manual/plugins/firmware_flash.tex | 2 +- manual/plugins/main.tex | 4 ++-- manual/plugins/rockbox_flash.tex | 2 +- manual/plugins/sort.tex | 2 +- manual/plugins/text_editor.tex | 2 +- manual/plugins/text_viewer.tex | 2 +- manual/preamble.tex | 11 ++++----- manual/rockbox_interface/main.tex | 10 ++++---- manual/rockbox_interface/wps.tex | 12 +++++----- manual/working_with_playlists/main.tex | 4 ++-- 18 files changed, 51 insertions(+), 54 deletions(-) diff --git a/manual/appendix/appendix.tex b/manual/appendix/appendix.tex index d295a42621..dfb53025c8 100644 --- a/manual/appendix/appendix.tex +++ b/manual/appendix/appendix.tex @@ -112,7 +112,7 @@ For open feature requests refer to Duplicates are really boring! \item Check that the feature hasn't already been implemented. Download the latest daily build and/or search the mail list archive. -\item Check that the feature is possible to implement (see \rockref{ref:NODO}). +\item Check that the feature is possible to implement (see \reference{ref:NODO}). \end{enumerate} \subsection{\label{ref:NODO}Features we will not implement} diff --git a/manual/configure_rockbox/display_options.tex b/manual/configure_rockbox/display_options.tex index 7091be3558..6afd2badb3 100755 --- a/manual/configure_rockbox/display_options.tex +++ b/manual/configure_rockbox/display_options.tex @@ -5,7 +5,7 @@ \nopt{player}{ \item[Browse fonts:] Browse the fonts that reside in your \fname{/.rockbox/fonts} directory. - Selecting one will activate it. See \rockref{ref:Loadingfonts} + Selecting one will activate it. See \reference{ref:Loadingfonts} for further details about fonts. } % \nopt{player} @@ -13,8 +13,8 @@ Opens the \setting{File Browser} in the \fname{/.rockbox/wps} directory and displays all \fname{.wps} files. Selecting one will activate it, stop will exit back to the menu. For further information about the WPS see - \rockref{ref:WPS}. For information about editing a .wps file see - \rockref{ref:ConfiguringtheWPS}. + \reference{ref:WPS}. For information about editing a .wps file see + \reference{ref:ConfiguringtheWPS}. \opt{h1xx,h300,x5}{ \item[Browse RWPS files:] @@ -226,7 +226,7 @@ \opt{HAVE_LCD_BITMAP}{ \item[Peak Meter:] The peak meter can be configured with a number of parameters. - (For a description of the peak meter see \rockref{sec:peakmeter}.) + (For a description of the peak meter see \reference{sec:peakmeter}.) \begin{description} \item[Peak Release:] This determines how fast the bar shrinks when the music becomes diff --git a/manual/configure_rockbox/file_view.tex b/manual/configure_rockbox/file_view.tex index e2643f1bdf..5170215bd4 100755 --- a/manual/configure_rockbox/file_view.tex +++ b/manual/configure_rockbox/file_view.tex @@ -30,7 +30,7 @@ information, thus disabling the file browser. You can browse the database by various tags and search them. Only information present in music file tags are shown. For a detailed description of Tag Cache - refer to \rockref{ref:tagcache}. + refer to \reference{ref:tagcache}. \item[Playlists:] The File Browser displays only directories and playlists, for simplified navigation. \item[Music:] The File Browser displays only folders, \fname{.m3u} files @@ -38,7 +38,7 @@ Files and directories starting with \fname{.} or with the ``hidden'' flag set are hidden. \item[Supported:] The File Browser displays all directories and files - supported by Rockbox (see \rockref{ref:Supportedfileformats}). + supported by Rockbox (see \reference{ref:Supportedfileformats}). Files and directories starting with \fname{.} or with the ``hidden'' flag set are hidden. \end{description} @@ -54,11 +54,11 @@ \item[Show Icons:] Rockbox has the ability to display an icon to the left of the file in the File Browser. For details of these icons, please see - \rockref{ref:Supportedfileformats}. + \reference{ref:Supportedfileformats}. \item[Tag Cache:] This option allows you to configure the Tag Cache. - See \rockref{ref:tagcache} for more information about using + See \reference{ref:tagcache} for more information about using the Tag Cache. \end{description} diff --git a/manual/configure_rockbox/language.tex b/manual/configure_rockbox/language.tex index 145cdf6aca..29740efdb1 100755 --- a/manual/configure_rockbox/language.tex +++ b/manual/configure_rockbox/language.tex @@ -1,2 +1,2 @@ \section{\label{ref:Language}Language} - This setting controls the language of the Rockbox user interface. Selecting a language will activate it. The language files must be in the \textbf{/.rockbox/lang/} directory. See \rockref{ref:Loadinglanguages} for further details about languages. + This setting controls the language of the Rockbox user interface. Selecting a language will activate it. The language files must be in the \textbf{/.rockbox/lang/} directory. See \reference{ref:Loadinglanguages} for further details about languages. diff --git a/manual/getting_started/main.tex b/manual/getting_started/main.tex index 5be736774e..4819fb16d5 100644 --- a/manual/getting_started/main.tex +++ b/manual/getting_started/main.tex @@ -132,7 +132,7 @@ from \wikilink{VoiceFiles}. For the English language, the file is called \fname{english.voice}. When it has been downloaded, unpack this file and copy it into the \fname{lang} folder which is inside the /\fname{.rockbox} folder on your Jukebox. Voice menus are turned on by default. See -\rockref{ref:Voiceconfiguration} for details on voice settings. +\reference{ref:Voiceconfiguration} for details on voice settings. \section{Running Rockbox} Remove your \dap from the computer's USB port. Unplug any connected power supply @@ -144,7 +144,7 @@ you see the Rockbox splash screen, Rockbox is loaded and ready for use. onto your player using Itunes, you will not be able to see your music because Itunes changes your files' names and hides them in directories in the \fname{Ipod\_Control} folder. You can view files placed on your \dap{} by Itunes -by initializing and using Rockbox's Tag Cache. See \rockref{ref:tagcache} for +by initializing and using Rockbox's Tag Cache. See \reference{ref:tagcache} for more information.} } @@ -163,7 +163,7 @@ defaults when a Rockbox build is updated. Thus, it is a good idea to save your settings using the \setting{Manage Settings} $\rightarrow$ \setting{Write .cfg file} function before updating your Rockbox build so that you can easily restore the settings if necessary. For additional information on how to save, load, and -reset Rockbox's settings, see \rockref{ref:SystemOptions}.} +reset Rockbox's settings, see \reference{ref:SystemOptions}.} \section{Uninstalling Rockbox} If you would like to go back to using the original \playername\ software, then diff --git a/manual/main_menu/fmradio.tex b/manual/main_menu/fmradio.tex index c67c388717..0867645e7c 100644 --- a/manual/main_menu/fmradio.tex +++ b/manual/main_menu/fmradio.tex @@ -110,7 +110,7 @@ station. Press \ButtonOff\ to stop recording. Press \ButtonPlay\ again to seamlessly start recording to a new file. The settings for the recording can be changed in the \ButtonFOne\ menu before - starting the recording. See \rockref{ref:Recordingsettings} + starting the recording. See \reference{ref:Recordingsettings} for details of recording settings. } \end{description} diff --git a/manual/main_menu/main.tex b/manual/main_menu/main.tex index 218d38cfaa..3e3b268774 100644 --- a/manual/main_menu/main.tex +++ b/manual/main_menu/main.tex @@ -18,7 +18,7 @@ the disk solely for the purpose of saving settings. Instead, Rockbox will save settings when it spins up the disk the next time, for example when refilling the MP3 buffer or navigating through the file browser. Changes to settings may therefore not be saved unless the \dap\ is shut down safely -(see \rockref{ref:Safeshutdown}). +(see \reference{ref:Safeshutdown}). \section{Navigating the Main Menu} \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD}{ @@ -69,25 +69,25 @@ settings may therefore not be saved unless the \dap\ is shut down safely {The list bookmarks screen}{} If the \setting{Save a list of recently created bookmarks} option is enabled then you can view a list of several recent bookmarks here and select one to -jump straight to that track. See \rockref{ref:Bookmarkconfigactual} +jump straight to that track. See \reference{ref:Bookmarkconfigactual} for more details on configuring bookmarking in Rockbox. \note{This option is off by default.} \section{Sound Settings} The \setting{Sound Settings} menu offers a selection of sound properties you may change to customize your listening experience. The details of this menu are -covered in detail in \rockref{ref:configure_rockbox_sound}. +covered in detail in \reference{ref:configure_rockbox_sound}. \section{General Settings} The \setting{General Settings} menu allows you to customize the way Rockbox looks and the way it plays music. The details of this menu are covered in detail in -\rockref{ref:configure_rockbox_general}. +\reference{ref:configure_rockbox_general}. \section{Manage Settings} The \setting{Manage Settings} option allows the saving and re-loading of user configuration settings, browse the hard drive for alternate firmwares, and finally to reset your \dap\ back to initial configuration. The details of this menu are -covered in detail in \rockref{ref:ManageSetting}. +covered in detail in \reference{ref:ManageSetting}. \section{Browse Themes} This option will display all the currently installed themes on the \dap, @@ -114,7 +114,7 @@ others will be full-blown themes. \note{Themes do not have to be purely visual. It is quite possible to create a theme that switches between audio configurations for use in the car, with headphones and when connected to an external amplifier. See -\rockref{ref:CreateYourOwnWPS} for more details. +\reference{ref:CreateYourOwnWPS} for more details. } \opt{CONFIG_TUNER}{\input{main_menu/fmradio.tex}} @@ -125,7 +125,7 @@ headphones and when connected to an external amplifier. See This menu allows you to work with playlists. Playlists can either be created automatically by playing a file in a directory directly, which will cause all of the files in that directory to be placed in the playlist, or they can be -created by hand using the \setting{File Menu} (see \rockref{ref:Filemenu}) +created by hand using the \setting{File Menu} (see \reference{ref:Filemenu}) or using the \setting{Playlist Options} menu. Both automatic and manually created playlists can be edited using this menu. @@ -141,7 +141,7 @@ from where you currently are. \item[Save Current Playlist:] Saves the current dynamic playlist, excluding queued tracks, to the specified file. If no path is provided then playlist is saved to current -directory (see \rockref{ref:Playlistsubmenu}). +directory (see \reference{ref:Playlistsubmenu}). \item[Recursively Insert Directories: ] If set to \setting{On}, then when a directory is inserted or queued into a @@ -160,7 +160,7 @@ directory (see \rockref{ref:Playlistsubmenu}). written for Rockbox. There are a wide variety of these supplied with Rockbox, including several games, some impressive demos and a number of utilities. A detailed description of the different plugins is to be found in -\rockref{ref:plugins}. +\reference{ref:plugins}. \section{\label{ref:Info}Info} This option shows RAM buffer size, battery voltage level and estimated time @@ -191,7 +191,7 @@ battery status, hard disk size and the amount of free space on the disk. This menu option saves the Rockbox configuration and turns off the hard drive before shutting down the machine. For maximum safety this procedure is recommended when turning off the \dap. (There is a very small risk - of hard disk corruption otherwise.) See \rockref{ref:Safeshutdown} + of hard disk corruption otherwise.) See \reference{ref:Safeshutdown} for more details. } @@ -206,6 +206,6 @@ battery status, hard disk size and the amount of free space on the disk. \opt{IPOD_4G_PAD,IPOD_VIDEO_PAD}{\ButtonMenu} \opt{IAUDIO_X5_PAD}{\ButtonRec} key, and it allows rapid access to the \setting{Shuffle} and \setting{Repeat} modes - (\rockref{ref:PlaybackOptions}) - and the \setting{Show Files} option (\rockref{ref:ShowFiles}). + (\reference{ref:PlaybackOptions}) + and the \setting{Show Files} option (\reference{ref:ShowFiles}). } diff --git a/manual/main_menu/recording.tex b/manual/main_menu/recording.tex index 2d3ee52799..9b6603007a 100644 --- a/manual/main_menu/recording.tex +++ b/manual/main_menu/recording.tex @@ -110,7 +110,7 @@ \item[Source:] Choose the source of the recording. This can be \opt{recorder,recorderv2fm,h1xx}{SPDIF (digital),} microphone or line in. - \opt{CONFIG_TUNER}{For recording from the radio see \rockref{ref:FMradio}.} + \opt{CONFIG_TUNER}{For recording from the radio see \reference{ref:FMradio}.} % Add h1xx here whenever it supports setting recording frequency. \opt{recorder,recorderv2fm} diff --git a/manual/plugins/firmware_flash.tex b/manual/plugins/firmware_flash.tex index dab7020ffd..869fba51dd 100644 --- a/manual/plugins/firmware_flash.tex +++ b/manual/plugins/firmware_flash.tex @@ -6,7 +6,7 @@ Firmware\_flash \par} -Use when flashing Rockbox (see \rockref{ref:FlashingRockboxReal}. +Use when flashing Rockbox (see \reference{ref:FlashingRockboxReal}. In the ideal case, you'll need this tool only once. For safety reasons you may wish to delete \textbf{firmware\_flash.rock} from \textbf{/.rockbox/rocks} once flashing is complete. diff --git a/manual/plugins/main.tex b/manual/plugins/main.tex index b4dee2426b..180bb1a521 100644 --- a/manual/plugins/main.tex +++ b/manual/plugins/main.tex @@ -14,9 +14,9 @@ text files, chip8 games), or from the \setting{Open with} option on the \section{Games} \opt{HAVE_LCD_BITMAP} - {See also the Chip{}-8 emulator in \rockref{ref:Chip8emulator} + {See also the Chip{}-8 emulator in \reference{ref:Chip8emulator} \opt{recorder,recorderv2fm,h1xx,h300,ipodcolor,ipodvideo} - {and Rockboy in \rockref{ref:Rockboy}}.} + {and Rockboy in \reference{ref:Rockboy}}.} \opt{HAVE_LCD_BITMAP}{\input{plugins/brickmania.tex}} diff --git a/manual/plugins/rockbox_flash.tex b/manual/plugins/rockbox_flash.tex index a627fdcdbc..6640744f17 100644 --- a/manual/plugins/rockbox_flash.tex +++ b/manual/plugins/rockbox_flash.tex @@ -7,6 +7,6 @@ Rockbox flash \par} For ``playing'' \fname{.UCL} files on flashed Jukeboxes. Reprograms the flash memory of -the Jukebox unit (see \rockref{ref:Rockboxinflash} for details). +the Jukebox unit (see \reference{ref:Rockboxinflash} for details). diff --git a/manual/plugins/sort.tex b/manual/plugins/sort.tex index f9e423adc0..69625f6b0a 100644 --- a/manual/plugins/sort.tex +++ b/manual/plugins/sort.tex @@ -1,5 +1,5 @@ \subsection{Sort} This plugin takes a file and sorts it in forward alphabetical order. Case is -ignored. This is useful for ordering playlists generated by the ``Create Playlist'' menu option (see \rockref{ref:Playlistsubmenu}). +ignored. This is useful for ordering playlists generated by the ``Create Playlist'' menu option (see \reference{ref:Playlistsubmenu}). diff --git a/manual/plugins/text_editor.tex b/manual/plugins/text_editor.tex index 08bd922074..df7085664d 100644 --- a/manual/plugins/text_editor.tex +++ b/manual/plugins/text_editor.tex @@ -1,7 +1,7 @@ \subsection{Text Editor} This plugin allows you to view and edit simple text documents on your DAP. You can view files by using \textbf{Open with} from the -\textbf{File Menu} (see \rockref{ref:Filemenu}). +\textbf{File Menu} (see \reference{ref:Filemenu}). \subsubsection{Usage} If you start the Text Editor from the plugin browser you will be greeted with diff --git a/manual/plugins/text_viewer.tex b/manual/plugins/text_viewer.tex index 9e8820800d..36d25367df 100644 --- a/manual/plugins/text_viewer.tex +++ b/manual/plugins/text_viewer.tex @@ -3,7 +3,7 @@ This is a Viewer for text files with word wrap. Just open a .txt file to display it. The text vewer features controls to handle various styles of text formatting, has top{}-of{}-file and bottom{}-of{}-file buttons. You can view files without a \fname{.txt} extension by using \emph{Open with} from the -\emph{File Menu} (see \rockref{ref:Filemenu}). +\emph{File Menu} (see \reference{ref:Filemenu}). \subsubsection{Mode settings} diff --git a/manual/preamble.tex b/manual/preamble.tex index d79655a540..e03b776d8f 100644 --- a/manual/preamble.tex +++ b/manual/preamble.tex @@ -250,7 +250,6 @@ commandchars=\\\{\}% } - % Use the nopt command to exclude a certain defined feature from a sectio % Example: % \nopt{ondio}{This text will be excluded for ondios} @@ -260,12 +259,10 @@ \ifthenelse{\optnvalue > 0}{}{#2} } - - -% Use the rockref to handle get a flexible reference command -% usage \rockref{ref_section} +% Use the reference to handle get a flexible reference command +% usage \reference{ref_section} \ifpdfoutput{ - \newcommand{\rockref}[1]{% + \newcommand{\reference}[1]{% section \ref{#1} (page \pageref{#1}) }} -{\newcommand{\rockref}[1]{section \ref{#1}}} +{\newcommand{\reference}[1]{section \ref{#1}}} diff --git a/manual/rockbox_interface/main.tex b/manual/rockbox_interface/main.tex index 2edf8528b6..009c05d754 100644 --- a/manual/rockbox_interface/main.tex +++ b/manual/rockbox_interface/main.tex @@ -144,12 +144,12 @@ You can select whether to browse using the \setting{File Browser} or the \setting{Tag Cache Browser} by adjusting the \setting{Show Files} setting. If you choose the \setting{File Browser}, the \setting{Show Files} setting also lets you select what types of files you wish to view. See -\rockref{ref:ShowFiles} for more information on the \setting{Show Files} +\reference{ref:ShowFiles} for more information on the \setting{Show Files} setting. \note{The \setting{File Browser} allows you to manipulate your files in ways that are not available within the \setting{Tag Cache Browser}. Read more about -\setting{Tag Cache} in \rockref{ref:tagcache}. The remainder of this section deals with the \setting{File Browser}.} +\setting{Tag Cache} in \reference{ref:tagcache}. The remainder of this section deals with the \setting{File Browser}.} \opt{ondio}{\fixme{Add information on hotplug/multivolume support}} @@ -179,7 +179,7 @@ that are not available within the \setting{Tag Cache Browser}. Read more about \opt{ONDIO_PAD}{\ButtonRight} \opt{RECORDER_PAD}{\ButtonRight/\ButtonPlay} & Executes an action. Depending on the file type, that action may vary. - (See \rockref{ref:Filemenu}) \\ + (See \reference{ref:Filemenu}) \\ % \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,PLAYER_PAD,RECORDER_PAD}{\ButtonOn} \opt{IAUDIO_X5_PAD,IPOD_4G_PAD}{\ButtonPlay} @@ -266,7 +266,7 @@ each option pertains both to files and directories): The \setting{Open With} function can be used to override the default action and select a viewer by hand. For example, this function can be used to view a text file even if the file has a non-standard extension (i.e., the file has an extension - of something other than \fname{.txt}). See \rockref{ref:Viewersplugins} + of something other than \fname{.txt}). See \reference{ref:Viewersplugins} for more details on viewers. \item [Create Directory:] Makes a new folder in the current folder on the disk. @@ -294,7 +294,7 @@ options: \item [Queue:] Queue is the same as Insert except queued tracks are deleted immediately from the playlist after they've been played. Also, queued tracks are not saved to - the playlist file (see \rockref{ref:playlistoptions}). + the playlist file (see \reference{ref:playlistoptions}). \item [Queue next:] Queue track(s) immediately after current playing track. \item [Queue last:] diff --git a/manual/rockbox_interface/wps.tex b/manual/rockbox_interface/wps.tex index 8df5384e0e..1b9c60760b 100644 --- a/manual/rockbox_interface/wps.tex +++ b/manual/rockbox_interface/wps.tex @@ -6,7 +6,7 @@ currently playing audio file. \opt{HAVE_LCD_BITMAP}{% The apperance of the WPS can be configured using wps configuration files. The items shown depend on your configuration -- all item can be turned on - or off independently. Refer to \rockref{ref:wps_tags} for details on how + or off independently. Refer to \reference{ref:wps_tags} for details on how to change the display of the WPS. \begin{itemize} \item Status bar: The Status bar shows Battery level, charger status, @@ -42,7 +42,7 @@ currently playing audio file. } } -See \rockref{ref:ConfiguringtheWPS} for details of customising +See \reference{ref:ConfiguringtheWPS} for details of customising your WPS (While Playing Screen). @@ -128,7 +128,7 @@ your WPS (While Playing Screen). \subsection{\label{ref:peak_meter}Peak Meter} The peak meter can be displayed on the While Playing Screen and consists of several indicators. For a picture of the peak meter, please see the While - Recording Screen in \rockref{ref:Whilerecordingscreen}. + Recording Screen in \reference{ref:Whilerecordingscreen}. \begin{description} \item [The bar:] @@ -159,7 +159,7 @@ your WPS (While Playing Screen). \subsubsection{Sound Settings} This is a shortchut to the \setting{Sound Settings Menu}, where you can configure volume, bass, treble, and other settings affecting the sound of your music. - See \rockref{ref:configure_rockbox_sound} for more information. + See \reference{ref:configure_rockbox_sound} for more information. \subsubsection{Playlist} The \setting{Playlist} submenu allows you to view, save, search and reshuffle the current @@ -246,7 +246,7 @@ your WPS (While Playing Screen). (Playlists), any files that Rockbox supports (Supported) or all files on the disk (All). - See \rockref{ref:PlaybackOptions} for more information about these + See \reference{ref:PlaybackOptions} for more information about these settings. \begin{table} @@ -268,7 +268,7 @@ your WPS (While Playing Screen). assignments swap over with the display orientation where it is logical for them to do so. - See \rockref{ref:Displayoptions} for more information about these + See \reference{ref:Displayoptions} for more information about these settings. \begin{table} diff --git a/manual/working_with_playlists/main.tex b/manual/working_with_playlists/main.tex index 147237918b..78079b46f8 100755 --- a/manual/working_with_playlists/main.tex +++ b/manual/working_with_playlists/main.tex @@ -20,7 +20,7 @@ Here are some common terms that are used in Rockbox when referring to playlists: \item[Dynamic playlist:] A dynamic playlist is a playlist that is created ``On the fly.'' Any time you insert or queue tracks using the - \setting{Playlist submenu} (see \rockref:{playlist_submenu}), you are creating (or adding + \setting{Playlist submenu} (see \reference:{playlist_submenu}), you are creating (or adding to) a dynamic playlist. \item[Insert:] In Rockbox, to \setting{Insert} an item into a playlist means @@ -80,7 +80,7 @@ Rockbox can create playlists in four different ways. \item [Queue:] Queue is the same as Insert except queued tracks are deleted immediately from the playlist after they've been played. Also, queued tracks - are not saved to the playlist file (see \rockref{ref:playlistoptions}). + are not saved to the playlist file (see \reference{ref:playlistoptions}). \item [Queue next:] Queue track(s) immediately after current playing track.