diff options
Diffstat (limited to 'manual/getting_started/main.tex')
-rw-r--r-- | manual/getting_started/main.tex | 37 |
1 files changed, 19 insertions, 18 deletions
diff --git a/manual/getting_started/main.tex b/manual/getting_started/main.tex index 9b68312723..f5eba1fae8 100644 --- a/manual/getting_started/main.tex +++ b/manual/getting_started/main.tex | |||
@@ -35,27 +35,28 @@ of call when looking for further help. | |||
35 | If you cannot find the information you are searching for on the Rockbox | 35 | If you cannot find the information you are searching for on the Rockbox |
36 | website there are a number of support channels you should have a look at. | 36 | website there are a number of support channels you should have a look at. |
37 | You can try the Rockbox forums located at \url{http://forums.rockbox.org/}. | 37 | You can try the Rockbox forums located at \url{http://forums.rockbox.org/}. |
38 | Another option are the mailing lists which can be found at | 38 | The mailing lists are another option, and can be found at |
39 | \url{http://www.rockbox.org/mail/}. From that page you can subscribe to the | 39 | \url{http://www.rockbox.org/mail/}. From that page you can subscribe to the |
40 | lists and browse the archives. For searching the list archives simply use | 40 | lists and browse the archives. To search the list archives simply use |
41 | the search field that is located on the left side of the website. | 41 | the search field that is located on the left side of the website. |
42 | Also you can ask on IRC. The main channel for Rockbox is \texttt{\#rockbox} | 42 | Furthermore, you can ask on IRC. The main channel for Rockbox is |
43 | on \url{irc://irc.freenode.net}. A bunch of helpful developers and users | 43 | \texttt{\#rockbox} on \url{irc://irc.freenode.net}. Many helpful developers |
44 | are usually around. Just join and ask -- if someone knows the answer you'll | 44 | and users are usually around. Just join and ask your question (don't ask to |
45 | ask!) -- if someone knows the answer you'll | ||
45 | usually get an answer pretty quickly. More information including IRC logs | 46 | usually get an answer pretty quickly. More information including IRC logs |
46 | can be found at \url{http://www.rockbox.org/irc/}. We also have a web client | 47 | can be found at \url{http://www.rockbox.org/irc/}. We also have a web client |
47 | for joining the rockbox IRC channel so there is no need for you | 48 | so that you can join the Rockbox IRC channel without needing |
48 | to install additional software to your computer. | 49 | to install additional software onto your computer. |
49 | 50 | ||
50 | If you think you have found a bug please make sure it actually is a bug and is | 51 | If you think you have found a bug please make sure it actually is a bug and is |
51 | still present in the most recent version of rockbox. You should try to | 52 | still present in the most recent version of Rockbox. You should try to |
52 | confirm that by using the above mentioned support channels first. After that | 53 | confirm that by using the above mentioned support channels first. After that |
53 | you can submit that issue to our tracker. Refer to \reference{sec:feedback} | 54 | you can submit that issue to our tracker. Refer to \reference{sec:feedback} |
54 | for details on how to use the tracker. | 55 | for details on how to use the tracker. |
55 | 56 | ||
56 | 57 | ||
57 | \section{Naming conventions and marks} | 58 | \section{Naming conventions and marks} |
58 | We have some conventions especially on naming that are intended to be | 59 | We have some conventions (especially for naming) that are intended to be |
59 | consistent throughout this manual. | 60 | consistent throughout this manual. |
60 | 61 | ||
61 | Manufacturer and product names are formatted in accordance with the standard | 62 | Manufacturer and product names are formatted in accordance with the standard |
@@ -70,23 +71,23 @@ you finding important parts or parts you could skip. The following icons | |||
70 | are used: | 71 | are used: |
71 | \\ | 72 | \\ |
72 | \note{This indicates a note. A note starts always with the text ``Note''. | 73 | \note{This indicates a note. A note starts always with the text ``Note''. |
73 | For easier finding of notes we have put this an icon in the margin like | 74 | In order to make finding notes easier each one is accompanied by |
74 | here. Notes are used to mark information that could help you | 75 | an icon in the margin as here. Notes are used to mark useful information |
75 | or indicate a possible ``weirdness'' in rockbox that would be explained. | 76 | that may help you to get the most out of Rockbox. |
76 | \\ | 77 | \\ |
77 | } | 78 | } |
78 | \warn{This is a warning. In contrast to notes mentioned above, a warning | 79 | \warn{This is a warning. In contrast to notes mentioned above, a warning |
79 | should be taken more seriously. While ignoring notes will not cause any serious | 80 | should be taken more seriously. Whereas ignoring notes will not cause any |
80 | damage ignoring warnings \emph{could} cause serious damage. If you are new to | 81 | serious damage, ignoring warnings \emph{could} cause serious damage to |
81 | rockbox you should really read the warnings before doing anything that is | 82 | your \dap{}. You really should read the warnings, especially if you are |
82 | warned about. | 83 | new to Rockbox. |
83 | \\ | 84 | \\ |
84 | } | 85 | } |
85 | \blind{This icon marks a section that is intended especially for the blind | 86 | \blind{This icon marks a section that is intended especially for the blind |
86 | and visually impaired. As they cannot | 87 | and visually impaired. As they cannot |
87 | read the manual in the same way sighted people do we have added some | 88 | read the manual in the same way sighted people do we have added some |
88 | additional descriptions. If you are not blind or visually impaired you most | 89 | additional descriptions. If you are not blind or visually impaired you |
89 | likely can completely skip these blocks. To make this easier, there is an | 90 | can probably completely skip these blocks. To make this easier, there is an |
90 | icon shown in the margin on the right. | 91 | icon shown in the margin on the right. |
91 | \\ | 92 | \\ |
92 | } | 93 | } |