background image

A

PPENDIX

B. WPS T

AGS

114

B. WPS Tags

B.1. Status Bar

Tag

Description

%we

Status Bar Enabled

%wd

Status Bar Disabled

These tags override the player setting for the display of the status bar. They must be
noted on their own line.

B.2. ID3 Info

Tag

Description

%ia

ID3 Artist

%ic

ID3 Composer

%id

ID3 Album Name

%ig

ID3 Genre Name

%in

ID3 Track Number

%it

ID3 Track Title

%iv

ID3 Version (1.0, 1.1, 2.2, 2.3, 2.4 or empty if no id3 tag)

%iy

ID3 Year

Remember that this information is not always available, so use the conditionals to show
alternate information in preference to assuming.

T

HE

R

OCKBOX MANUAL

A

RCHOS

O

NDIO

Summary of Contents for Archos Ondio 128 FM

Page 1: ...The Rockbox Manual for Archos Ondio 128 FM rockbox org October 20 2008 ...

Page 2: ...se Maria Garcia Valdecasas Bernal Peter Schlenker Version r18824 18843M 3 0 1 081020 Built using pdfL A TEX Permission is granted to copy distribute and or modify this document un der the terms of the GNU Free Documentation License Version 1 2 or any later version published by the Free Software Foundation with no Invari ant Sections no Front Cover Texts and no Back Cover Texts A copy of the licens...

Page 3: ...ng Rockbox 15 2 6 1 Automatic Uninstallation 15 2 6 2 Manual Uninstallation 15 3 Quick Start 16 3 1 Basic Overview 16 3 1 1 The player s controls 16 3 1 2 Turning the player on and off 17 3 1 3 Putting music on your player 17 3 1 4 The first contact 17 3 1 5 Basic controls 17 3 1 6 Basic concepts 18 3 2 Customising Rockbox 18 4 Browsing and playing 19 4 1 File Browser 19 4 1 1 File Browser Control...

Page 4: ...5 The Main Menu 34 5 1 Introducing the Main Menu 34 5 2 Navigating the Main Menu 34 5 3 Recent Bookmarks 35 5 4 Files 35 5 5 Database 35 5 6 Now Playing Resume Playback 35 5 7 Settings 35 5 7 1 Sound Settings 36 5 7 2 General Settings 36 5 7 3 Manage Settings 36 5 7 4 Theme Settings 36 5 7 5 Recording Settings 36 5 8 Recording 36 5 8 1 While Recording Screen 36 5 9 FM Radio 37 5 10 Playlist 38 5 1...

Page 5: ...oice 52 8 Theme Settings 54 9 Recording Settings 55 9 1 Quality 55 9 2 Frequency 55 9 3 Source 56 9 4 Channels 56 9 5 Independent Frames 56 9 6 File Split Options 56 9 7 Prerecord Time 57 9 8 Clear Recording Directory 57 9 9 Trigger 57 10 Plugins 59 10 1 Games 59 10 1 1 Blackjack 59 10 1 2 BrickMania 60 10 1 3 Bubbles 61 10 1 4 Chessbox 62 10 1 5 Chopper 63 10 1 6 Dice 63 10 1 7 Flipit 63 10 1 8 J...

Page 6: ... 79 10 2 4 Demystify 80 10 2 5 Fire 80 10 2 6 Logo 81 10 2 7 Mandelbrot 81 10 2 8 Mosaique 82 10 2 9 Oscilloscope 82 10 2 10 Plasma 83 10 2 11 Snow 83 10 2 12 Starfield 83 10 2 13 VU meter 84 10 3 Viewers 84 10 3 1 Shortcuts 85 10 3 2 Chip 8 Emulator 86 10 3 3 JPEG viewer 86 10 3 4 Movie Player 87 10 3 5 Rockbox flash 87 10 3 6 Search 87 10 3 7 Sort 88 10 3 8 Text Viewer 88 10 3 9 VBRfix 89 10 3 1...

Page 7: ...Files 107 11 3 2 Specifications for cfg Files 107 11 3 3 The MANAGE SETTINGS menu 108 11 4 Firmware Loading 108 11 4 1 Using ROLO Rockbox Loader 109 11 5 Rockbox in Flash 109 11 5 1 Introduction 109 11 5 2 Terminology and Basic Operation 109 11 5 3 Initial Flashing Procedure 110 11 5 4 Updating the Rockbox Image in Flash 111 11 5 5 Restoring the Original Flash ROM Contents 111 A File formats 112 A...

Page 8: ...rts 125 D 2 Feature ideas 125 D 2 1 Rules for submitting a new feature idea 125 D 2 2 Features we will not implement 126 E Changelog 128 E 1 What is new since v2 5 128 E 1 1 New features 128 E 1 2 Enhancements 129 E 1 3 New codecs supported 130 F Credits 131 G Licenses 134 G 1 GNU Free Documentation License 134 G 2 The GNU General Public License 142 THE ROCKBOX MANUAL ARCHOS ONDIO ...

Page 9: ...een put into making Rockbox sound the best it can and improvements are constantly being made All models have access to a large number of plugins including many games applications and graphical demos You can load different configurations quickly for different purposes e g a large font for in your car different sound settings for at home Rockbox features a very wide range of languages and all suppor...

Page 10: ...lp you finding important parts or parts you could skip The following icons are used Note This indicates a note A note starts always with the text Note For easier finding b of notes we have put this an icon in the margin like here Notes are used to mark infor mation that could help you or indicate a possible weirdness in rockbox that would be explained Warning This is a warning In contrast to notes...

Page 11: ...d by themes Depending on your taste you might want to install additional themes to change the look of Rockbox 2 2 Prerequisites Before installing Rockbox you should make sure you meet the prerequisites You may need some additional tools for installation In most cases these will already be available on your computer but if not installing some additional software might be necessary USB connection To...

Page 12: ...u to Automatically install all needed components for using Rockbox Small Installa tion Automatically install all suggested components Full Installation Selectively install optional components Install additional themes Install voice files and generate talk clips Uninstall all components you installed using Rockbox Utility Prebuilt binaries for Windows Linux and MacOS X are available at the ZRockbox...

Page 13: ... daily builds are development versions which change frequently they may behave differently than described in this manual or they may introduce new and maybe annoying bugs If you do not want to get undefined behaviour from your player you should stick to the current stable release if there is one for your player If you want to help with project development you can try devel opment builds and help b...

Page 14: ... drive Do not try to create a separate directory on your player for the fonts The zip already contains the correct internal structure 2 3 3 Enabling Speech Support optional If you wish to use speech support you will also need a voice file English ones are available from http www rockbox org daily shtml Download the voice package for your player and unzip it directly to the root of your player You ...

Page 15: ...g Rockbox Utility If you installed Rockbox manually you can still use Rockbox Utility for uninstallation but will not be able to do this selectively 2 6 2 Manual Uninstallation If you would like to go back to using the original Archos software connect the player to your computer and delete the ajbrec ajz file If you wish to clean up your disk you may also wish to delete the rockbox direc tory and ...

Page 16: ...ide which is the MMC slot Holding the player with this slot in the described position you ll find the following On the curved top it has the headphone jack to the left the On Off button is in the middle and the line in jack to the right Apart from the already mentioned MMC slot you will find the USB connector on the player s right side Placed on the upper side of the device right below the flat di...

Page 17: ...tion of Rockbox for more information see sec tion 5 1 page 34 To browse the files on you player select FILES see section 4 1 page 19 and to browse in a view that is based on the meta data1 of your audio files select DATABASE see section 4 2 page 22 3 1 5 Basic controls When browsing files and moving through menus you usually get a list view presented The navigation in these lists are usually the s...

Page 18: ...ile In the file browser this is the file or directory that is highlighted by the cursor From the WPS this is the currently playing file Also there are some actions that do not apply to the current file but refer to the screen from which the context menu gets called One example is the playback menu which can be called using the context menu from within the WPS 3 2 Customising Rockbox Rockbox User I...

Page 19: ... BROWSER the SHOW FILES setting lets you select what types of files you wish to view See section 7 3 page 47 for more information on the SHOW FILES setting Note The FILE BROWSER allows you to manipulate your files in ways that are not b available within the DATABASE BROWSER Read more about DATABASE in section 4 2 page 22 The remainder of this section deals with the FILE BROWSER Unlike the Archos F...

Page 20: ...s you to perform certain operations on files or directories To access the CONTEXT MENU position the selector over a file or directory and access the context menu with Long Right Note The CONTEXT MENU is a context sensitive menu If the CONTEXT MENU is in b voked on a file it will display options available for files If the CONTEXT MENU is invoked on a directory it will display options for directorie...

Page 21: ...ects the file type and runs the appropriate plugin The 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 txt See section 10 3 page 84 for more details on viewers Create Directory Create a new directory ...

Page 22: ...icker area Key Action Left Right Move left and right Mode Deletes the letter to the left of the cursor Long Mode Accepts the deletion Up Down Returns to the picker area Table 4 2 Line edit mode 4 2 Database 4 2 1 Introduction This chapter describes the Rockbox music database system Using the information con tained in the tags ID3v1 ID3v2 in your audio files Rockbox builds and maintains a database ...

Page 23: ...run UPDATE NOW Initialize Now You can force Rockbox to rescan your disk for tagged files by using the INITIALIZE NOW function in the DATABASE MENU Warning INITIALIZE NOW removes all database files removing runtimedb data also and rebuilds the database from scratch Update Now UPDATE NOW causes the database to detect new and deleted files Unlike INITIALIZE NOW the UPDATE NOW function does not remove...

Page 24: ...l build of the database and do not load it to RAM Tag Type Origin filename string system album string id tag albumartist string id tag artist string id tag comment string id tag composer string id tag genre string id tag grouping string id tag title string id tag bitrate numeric id tag discnum numeric id tag year numeric id tag tracknum numeric id tag filename autoscore numeric runtime db lastplay...

Page 25: ...lock status memory access indicator In contrast to all other items the status bar is always at the top of the screen Scrolling path and filename of the current song The ID3 track name The ID3 album name The ID3 artist name Bit rate VBR files display average bitrate and avg Elapsed and total time A slidebar progress meter representing where in the song you are Peak meter Note b The number of lines ...

Page 26: ... the While Playing Screen and consists of several indicators For a picture of the peak meter please see the While Recording Screen in section 5 8 1 page 36 The bar This is the wide horizontal bar It represents the current volume value The peak indicator This is a little vertical line at the right end of the bar It indicates the peak volume value that occurred recently The clip indicator This is a ...

Page 27: ...list entry and the icon for moving a playlist entry Show Indicies This toggles display of the line numbering for the playlist Track Display This toggles between filename only and full path for playlist entries Save Current Playlist Allows the current playlist to be saved as a m3u playlist file Playlist catalog View catalog This lists all playlists that are part of the Playlist catalog You can load...

Page 28: ...okmarks This allows you to create a bookmark in the currently playing track Show Track Info Figure 4 4 The track info viewer This screen is accessible from the WPS screen and provides a detailed view of all the identity information about the current track This info is known as meta data and is stored in audio file formats to keep information on artist album etc To access this screen press Long Mod...

Page 29: ...mode Right Left Temporarily increase decrease pitch by 2 0 Mode Reset pitch to 100 On Off Leave the Pitch Screen Warning Changing the pitch can cause audible Artifacts or Dropouts 4 4 Working with Playlists 4 4 1 Playlist terminology Some common terms that are used in Rockbox when referring to playlists Directory A playlist One of the keys to getting the most out of Rockbox is under standing that ...

Page 30: ... a song to the current playlist rather than erasing the current playlist see the section below on how to add music to a playlist By using Insert and Queue functions If playback is stopped the INSERT and QUEUE functions can be used as described in 4 4 3 to create a new playlist instead of adding to an existing one This will erase any dynamic playlist By using the Playlist catalog The PLAYLIST CATAL...

Page 31: ...he most recent INSERT operation If no tracks have yet been added via an INSERT new tracks will be added immediately after the current playing track If playback is stopped a new dynamic playlist will get created with the selected tracks Insert Next Add track s immediately after current playing track no matter what else has been inserted Insert Last Add track s to end of playlist Insert Shuffled Add...

Page 32: ...e PLAYLIST sub menu in the WPS just select RESHUFFLE Moving and removing tracks To move or remove a track from the current playlist enter the PLAYLIST VIEWER by selecting VIEW CURRENT PLAYLIST in the PLAYLIST submenu in the WPS context menu or the MAIN MENU Once in the PLAYLIST VIEWER open the context menu on the track you want to move or remove If you want to move the track select MOVE in the con...

Page 33: ... 4 7 Helpful Hints Including subdirectories in playlists You can control whether or not Rockbox includes the contents of subdirectories when adding an entire directory to a playlists Set the MAIN MENU SETTINGS PLAYLIST RECURSIVELY INSERT DIRECTORIES setting to YES if you would like to include tracks in subdirectories as well as tracks in the currently selected directory THE ROCKBOX MANUAL ARCHOS O...

Page 34: ...ving 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 player is shut down safely see section 3 1 2 page 17 5 2 Navigating the Main Menu Key Action Up Moves up in the menu Inside a setting increases the value or chooses next op...

Page 35: ...page 22 5 6 Now Playing Resume Playback Go to the WHILE PLAYING SCREEN and resume if music playback is stopped or paused and there is something to resume see section 4 3 page 25 5 7 Settings The SETTINGS menu allows to set or adjust many parameters that affect the way your player works There are many submenus for different parameter areas Every time you are setting a value of a parameter and that ...

Page 36: ...layer back to initial configuration This menu also allows the user to load different versions of the Rockbox firmware The details of this menu are covered in section 11 3 page 107 5 7 4 Theme Settings The THEME SETTINGS menu contains options that control the visual apperance of Rock box The details of this menu are covered in section 8 page 54 5 7 5 Recording Settings The RECORDING SETTINGS menu a...

Page 37: ...w recording The frequency channels and quality settings are shown on the last line The controls for this screen are Key Action Up Down Select setting Left Right Adjust selected setting Mode Start recording While recording pause recording press again to continue On Off Exit RECORDING SCREEN While recording Stop recording Long Mode Open RECORDING SETTINGS see sec tion 9 page 55 5 9 FM Radio Figure 5...

Page 38: ...thout selecting anything Removing a preset Long Mode to open the menu select PRESET to go to the presets list Use Up and Down to move the cursor and then press Long Right on the preset that you wish to remove then select REMOVE PRESET Recording Double press Mode to start recording the currently playing station Press On Off to stop recording The settings for the recording can be changed in the re s...

Page 39: ...page 59 5 12 System This option shows RAM buffer size battery voltage level and estimated time remain ing disk total space and disk free space Rockbox Info Displays some basic system information This is from top to bottom the amount of memory Rockbox has available for storing music the buffer The battery status Memory size and amount of free space on the two data volumes this info is given seperat...

Page 40: ...Values higher than 0 dB are available and can be used to raise the volume more than would otherwise be possible These volume levels will ordinarily lead to distorted sound but might work nicely for music that has an other wise low volume level The volume can be adjusted from a minimum of 100 dB to a maximum of 12 dB 6 2 Bass This setting emphasises or suppresses the lower bass frequencies in the s...

Page 41: ...ght Plays the right channel in both stereo channels Karaoke Removes all sound that is common to both channels Since most music is recorded with vocals being equally present in both channels to make the singer sound centrally placed this often but not always has the effect of removing the voice track from a song This setting also very often has other undesirable effects on the sound 6 6 Stereo Widt...

Page 42: ...ing only has an effect if LOUDNESS is set to a value larger than 0dB 6 10 MDB Micronas Dynamic Bass The rest of the parameters in this menu relate to the Micronas Dynamic Bass MDB function MDB is designed to enable the user to hear bass notes that the headphones and or speakers are not capable of reproducing Every tone has a fundamental fre quency the main tone and also several harmonics which are...

Page 43: ...which harmonics are generated Some of the lower fundamentals near the cut off range will have their lower harmonics cut since they will be below the range of the speakers Fundamentals between the cut off frequency and the lower frequency will have their harmonics proportionally boosted to compensate and restore the loudness of these notes For most users the defaults should provide an improvement i...

Page 44: ...laylist will not repeat when it is finished Note If you have the AUTO CHANGE DIRECTORY option set to YES Rock b box will move on to the next directory on your hard drive If the AUTO CHANGE DIRECTORY option is set to NO playback will stop when the cur rent directory or playlist is finished All The current playlist will repeat when it is finished One Repeat one track over and over Shuffle When the c...

Page 45: ... Rockbox must stop playing and wait for more data from the disk which causes your music to skip The anti skip setting tells Rockbox how much extra buffer memory to spare to handle this situation This setting therefore allows you to reduce the chances of there being a gap or pause during playback of songs The anti skip buffer can safely be kept at zero It will eventually be eliminated Note Having a...

Page 46: ...igned to speed up navigation and prevent unintentional track skip ping when listening to long audio tracks SKIP LENGTH changes the behavior of the Left and Right buttons so that they skip by a given number of minutes instead of skipping to a new track Note To skip tracks with this setting set to a time interval press Short Left Long b Right to go forward and Short Right Long Left to go back 7 2 Pl...

Page 47: ...den Playlists The FILE BROWSER displays only directories and playlists for simpli fied navigation Show Filename Extensions This option controls how file extensions are shown in the File Browser Off The file extensions are never shown On The file extensions are always shown Only unknown types Only the extensions of unknown filetypes are shown Only when viewing all types Only show file extensions wh...

Page 48: ...he number of pixels the text should move for each step as used by the Scroll Speed setting Bidirectional Scroll Limit Rockbox has two different automatic horizontal scrolling methods 1 always scrolling the text to the left until the line has ended and then beginning again at the start and 2 moving to the left until you can read the end of the line and then scrolling right until you see the beginni...

Page 49: ...ying music from the player via the analogue output to some other recording device Clip Hold Time The number of seconds that the clipping indicator will be visible after clipping is detected Clip Counter Show the number of times the clip indicator went active during recording in front of the peak meters Scale Select whether the peak meter displays linear or logarithmic values The human ear perceive...

Page 50: ...Capacity This setting can be used to tell Rockbox what capacity in mAh the battery being used has The default is 1000mAh which is the capacity value for the standard batteries shipped with the player Rockbox uses this value to estimate remaining battery life for the info screen and WPS Changing this set ting has no effect whatsoever on actual battery life This setting only affects the accuracy of ...

Page 51: ...sting bmark file the current position information will be added to the front of the existing list up to the maximum number of allowed bookmarks per file currently 10 If no bmark file exists one will be created with the new bookmark information Finally if the MAINTAIN A LIST OF RECENTLY USED BOOKMARKS option is enabled the bookmarking information will be added to recent bookmarks list Yes Recent On...

Page 52: ...st be in the rockbox langs directory See section 11 1 3 page 103 for further details about languages 7 9 Voice Voice Menus This option controls the voicing of menus settings as they are selected by the cursor In order for this to work a voice file must be present in the rockbox langs directory on the player Voice files are large and are not shipped with Rockbox by default The voice file is the nam...

Page 53: ...ORIES You can use pre generated talk clips to have filenames spoken properly but you must enable this explicitly see below Use File talk Clips This option turns on the use of talk clips for files On Use special pre recorded MP3 files for each file This functions the same as for directories except that the talk clip file must have the same name as the described file with an extra talk extension e g...

Page 54: ... for use in the car with headphones and when connected to an external amplifier See section 11 2 2 page 104 for more details Browse Fonts Browse the installed fonts on your player Selecting one will activate it See section 11 1 2 page 103 for further details about fonts Browse WPS files Opens the FILE BROWSER in the rockbox wps directory and displays all wps files Selecting one will activate it st...

Page 55: ...The quality setting is just a way of selecting an average bit rate or number of bits per second for a recording When this setting is lowered recordings are compressed more meaning worse sound quality and the average bitrate changes as follows Frequency Bitrate Kbit s quality 0 7 44100Hz stereo 75 80 90 100 120 140 160 170 22050Hz stereo 39 41 45 50 60 80 110 130 44100Hz mono 65 68 73 80 90 105 125...

Page 56: ... be used to split up long recordings into manageable pieces The splits are seamless frame accurate no audio is lost at the split point The break between recordings is only the time required to stop and restart the recording on the order of 2 4 seconds Split Measure This option controls wether to split the recording when the SPLIT FILE SIZE is reached or when the SPLIT TIME has elapsed What to do w...

Page 57: ... When you record live music you may not be interested in that chord the guitarist strokes for two minutes before the show to verify his amp is turned on The trigger features numerous parameters to adapt its behaviour to the desired situation Trigger This parameter specifies the trigger mode When set to OFF the recording must be started manually and apart from the Prerecord time no other parameter ...

Page 58: ... unit of the stop threshold depends on the settings of the peak meter There s also a small triangular marker in the peak meter at the bottom of the screen In contrast to the start threshold marker it points to the left The value OFF turns the stop condition off With this setting you have to stop the recording manually for at least This time specifies the duration the signal must drop below the sto...

Page 59: ...rted automatically by opening an associated file i e text files chip8 games or from the OPEN WITH option on the CONTEXT MENU 10 1 Games See also the Chip 8 emulator in section 10 3 2 page 86 10 1 1 Blackjack Figure 10 1 Blackjack Blackjack a game played in casinos around the world is now available in the palm of your hand The rules are simple try to get as close to 21 without going over or simply ...

Page 60: ...wn Down Save game On Off Return to menu or cancel 10 1 2 BrickMania Figure 10 2 BrickMania BrickMania is a clone of the classic game Breakout The aim of the game is to destroy all the bricks by hitting them with the ball once or more Sometimes a special item falls down when you destroy a brick For a special item to take effect you must catch it with the paddle Look out for the bad ones THE ROCKBOX...

Page 61: ...se the ball Fire On Off Open menu Quit 10 1 3 Bubbles Figure 10 3 Bubbles The goal of the game is to beat each level as quickly as possible by clearing the board of all bubbles Bubbles are removed from the board when a cluster of three of more of the same type is formed The game is over when any bubbles on the board extend below the bottom line To make things more difficult the entire board is shi...

Page 62: ...you to select the one you want to watch After that you can scroll back and forth through the moves of the game If the menu is invoked while in the viewer the user is allowed to select a new match from the same file or quit the game Force play while the computer is thinking will cause it to make its move immedi ately If done while it s your turn the computer will move for you and flip the board so ...

Page 63: ... ceiling or the floor How long can you fly your chopper Key Action Up Mode Make chopper fly On Off Enter menu 10 1 6 Dice Dice is a simple dice rolling simulator Select number and type of dice to roll in a menu and start by choosing Roll Dice The result is shown as individual numbers as well as the total of the rolled dice Key Action Mode Roll dice again On Off Quit 10 1 7 Flipit Figure 10 5 Flipi...

Page 64: ...re 10 6 Jewels Jewels is a simple yet addicting game which involves swapping pairs of jewels in order to form connected segments of three or more of the same type The goal of the game is to score as many points as possible before running out of available moves Higher points are awarded to larger combos The game advances to the next level after every one hundred points and randomly clears several j...

Page 65: ...n Up Down Left Right Move Character On Off Menu 10 1 10 Minesweeper Figure 10 8 Minesweeper plugin The classic game of minesweeper Use the Up and Down keys to select the required percentage of mines to set the difficulty then press the Mode key to begin The aim of the game is to uncover all of the squares on the board If a mine is un covered then the game is over If a mine is not uncovered then th...

Page 66: ...gbox Figure 10 9 pegbox To beat each level you must destroy all of the pegs If two like pegs are pushed into each other they disappear except for triangles which form a solid block and crosses which allow you to choose a replacement block Key Action In game Up Down Left Right to move around On Off to select save Mode Right to restart level Mode Up to go up a level Mode Down to go down a level Mode...

Page 67: ...r up Down Right player down On Off Quit 10 1 13 Robotfindskitten Figure 10 11 Robotfindskitten In this game you are robot Your job is to find kitten This task is complicated by the existence of various things which are not kitten Robot must touch items to determine if they are kitten or not The game ends when robotfindskitten Key Action Up Down Left Right Move robot On Off Quit THE ROCKBOX MANUAL ...

Page 68: ...e level increases making the blocks fall faster If the pile of blocks reach the ceiling the game is over Key Action Left Move left Right Move right Down Move down Mode Up Rotate left Up Rotate right Mode Drop On Off Quit 10 1 15 Rockblox1d Rockblox1d is a game for people who find rockblox too hard In this version the second dimension is missing so the user only has to move the bricks down No horiz...

Page 69: ...r Key controls Key Action Left Right Up and Down Move Tile Long Mode Shuffle Mode Change between picture and numbered tiles On Off Stop the game 10 1 17 Snake Figure 10 14 Snake This is the popular snake game The aim is to grow your snake as large as possible by eating the dots that appear on the screen The game will end when the snake touches either the borders of the screen or itself THE ROCKBOX...

Page 70: ...Each time an apple is eaten the snake gets longer The game ends when the snake hits a wall or runs into itself Key Action In menu Up Down Set game speed Right Select starting maze Left Select game type A or B Mode Start the game In game Up Down Left Right Steer the snake Mode Pause and resume the game On Off Quit In game A the maze stays the same in game B after an increasing number of apples eate...

Page 71: ...el format see http sokobano de wiki index php title Level format Key Action In game Up Down Left Right Move the sokoban up down left or right On Off Menu Mode Left Back to previous level Mode Up Restart level Mode Right Go to next level Mode Undo last movement Mode Down Redo previously undone move Solution playback Mode Pause resume Up Down Increase decrease playback speed Left Right Go backward f...

Page 72: ... rather low perhaps one in thirty hands For the full set of rules to the game and other facinating information visit http www solitairecentral com rules klondike html Key Action Up Down Left Right Move Cursor around Mode Select cards move cards reveal hidden cards Long Mode If a card was selected unselect it else Draw 3 new cards from the remains stack Long Down Put the card from the top of the re...

Page 73: ...ght Down Teleport Mode On Off Pause game On Off Quit 10 1 22 Star Figure 10 19 Star game This is a puzzle game It is actually a rewrite of Star a game written by CDK designed for the hp48 calculator Rules Take all of the o s to go to the next level You can switch control between the filled circle which can take o s and the filled square which is used as a mobile wall to allow your filled circle to...

Page 74: ...oku games stored one game per file in text files with the ss extension see links below You then browse these games using the normal FILE BROWSER and open the file to launch Sudoku You can create and save your own grids under the NEW menu option Enter the menu as described in the key table below when you have finished and enter the full path to save to including the ss extension e g sudoku new ss T...

Page 75: ...cated near the bottom of that page http www angusj com sudoku Kjell s Sudoku generator solver http kjell haxx se sudoku 10 1 24 Wormlet Figure 10 21 Wormlet game Wormlet is a multi worm game on a multi threaded multi functional Rockbox console You navigate a hungry little worm Help your worm to find food and to avoid poisoned argh tiles The goal is to turn your tiny worm into a big worm for as lon...

Page 76: ... the annoying tendency to accumulate Worms Thou shall not eat worms Neither other worms nor thyself Eating worms is blasphemous cannibalism not healthy and causes instant death And it doesn t help anyway the other worm isn t hurt by the bite It will go on creeping happily and eat all the food you left on the table Walls Don t crash into the walls Walls are not edible Crashing a worm against a wall...

Page 77: ... If the score board entry displays Argh it means the worm is dead because it tried to eat an argh Until we can make the worm say Argh it is your job to say Argh aloud Wormed The worm tried to eat another worm or even itself That s why it is dead now Making traps for other players with a worm is a good way to get them out of the game Hints Initially you will be busy with controlling your worm Try t...

Page 78: ...o get in the way of enemy balls because if they hit you or your trail you lose a life To finish a level you have to section off more than 75 Key Action Up Down Left Right Move around the arena Mode Pause On Off Open menu 10 2 Demos 10 2 1 Bounce Figure 10 23 Bounce This demo is of the word Rockbox bouncing across the screen In SCROLL MODE the bouncing text is replaced by a different one scrolling ...

Page 79: ...s The credits plugin scrolls the entire list of the names of all the Rockbox contributors after displaying the Rockbox logo and version This plugin is called when selecting VERSION from the SYSTEM section of the Rockbox main menu Exit at any time by pressing Left or On Off 10 2 3 Cube Figure 10 24 Cube This is a rotating cube screen saver in 3D Key Action Mode Right Display at maximum frame rate M...

Page 80: ...Key Action Up Down Increase decrease speed Right Left Add remove polygon On Off Quit 10 2 5 Fire Figure 10 26 Fire Fire is a demo displaying a fire effect Key Action Up Down Increase decrease number of flames Mode Toggle flame type Right Toggle moving flames On Off Quit THE ROCKBOX MANUAL ARCHOS ONDIO ...

Page 81: ... 10 2 7 Mandelbrot Figure 10 27 Mandelbrot This demonstration draws fractal images from the Mandelbrot set using the greyscale engine Key Action Direction keys Move about the image Mode Mode Up Zoom in Mode Down Zoom out Mode Left Decrease iteration depth less detail Mode Right Increase iteration depth more detail Mode On Off Reset and return to the default image On Off Quit THE ROCKBOX MANUAL ARC...

Page 82: ... Figure 10 29 Oscilloscope This demo shows the shape of the sound samples that make up the music being played Keys Key Action Mode Toggle filled curve plot Mode Right Toggle whether to scroll or not Mode Left Toggle drawing orientation Mode On Off Pause the demo Up Down Increase decrease volume Right Left Increase decrease speed On Off Exit demo THE ROCKBOX MANUAL ARCHOS ONDIO ...

Page 83: ... effect Key Action Up Down Adjust frequency On Off Quit 10 2 11 Snow Figure 10 31 Have you ever seen snow falling This demo replicates snow falling on your screen If you love winter you will love this demo Or maybe not Press On Off to quit 10 2 12 Starfield Figure 10 32 Starfield THE ROCKBOX MANUAL ARCHOS ONDIO ...

Page 84: ...lled after LED volume displays and the mini meter option allows for the display of small meters in addition to the main display as above From the settings menu the decay time for the meter its memory the meter type and the meter scale can be changed Key Action On Off Save settings and quit Mode Help Long Mode Settings Up Raise Volume Down Lower Volume 10 3 Viewers Viewers are plugins which are ass...

Page 85: ...w you a list with the entries in the file Selecting one of them will then exit the plugin and leave you within the directory selected or with the file selected in the file browser You can then play the file or do with it whatever you want The file will not be played automatically If the link file contains only one entry no list will be shown you will directly jump to that location The file shortcu...

Page 86: ...8k file That c8k file contains 16 characters describing the mapping from the Chip8 keyboard to the default key mapping that way several Chip8 keys can be pressed using only one Rockbox key For example a file containing the single line CODE 0122458469ABCDEF would correspond to the following non default mappings 3 2 6 8 7 4 8 6 The default keymappings are Chip8 Off 0 1 2 3 4 5 6 7 8 9 A B C D E F Ke...

Page 87: ...ssages Processing could also fail if the image is too big to decode which will be explained by a respective message 10 3 4 Movie Player Play movies on your player In order to do this movies must be in AVI format and then converted to RVF Rockbox s own video format For more details on how to use this plugin please see ZVideoTutorial 10 3 5 Rockbox flash For playing UCL files on a flashed player Rep...

Page 88: ...ggle autoscroll Long Mode Enter menu On Off Exit text viewer The Viewer s Menu Quit Exits the plugin Viewer Options Encoding sets the codepage in the text viewer Available settings UTF 8 Unicode BIG5 Traditional Chinese KSX 1001 Korean GB 2312 Simple Chinese SJIS Japanese CP1250 Central European ISO 8859 2 Latin Extended ISO 8859 9 Turkish ISO 8859 6 Arabic ISO 8859 11 Thai CP1251 Cyrillic ISO 885...

Page 89: ...scrolling in number of lines per scroll step available options are 1 to 10 lines As an example a setting of 4 will scroll up the text four lines per second Show Playback Menu controls the playback of the currently loaded playlist and change the volume of your playerwithout leaving the plugin Return to the text view Note The text viewer automatically saves its settings and also stores the current p...

Page 90: ...Note Seeking within the wav file or changing the volume once the plugin is running is b not possible Wavplay uses the sound settings that were used before except for pitch The only action that can be performed is to stop by pressing On Off and Wavplay will be exited and you are returned to the filebrowser If the end of the file has been reached you will also be returned to the filebrowser 10 3 11 ...

Page 91: ... rockbox zxboxq z80 Save Snapshot Saves a snapshot of the current state You would enter the full path and desired name for example games zx snapshots chuckie sna The snapshot format will be chosen after the extension you specified per default z80 will be taken in case you leave it open Toggle Fast Mode Toggles fastest possible emulation speed no sound maximum frameskip etc This is Useful when load...

Page 92: ...ce you finish your ses sion you can find the benchmark output data in a file on your player battery bench txt Please submit your results to the Rockbox wiki ZBatteryRuntime How it works After you load the plug in the operation of your player continues as normal You can do whatever you could do before loading the plugin except loading another plugin If you happen to load a plugin while benchmarking...

Page 93: ... Voltage The battery voltage the moment the measurement was captured Measure ments are captured when this number changes while benchmarking This column can be used to give quite interesting graphs in a spreadsheet program Excel Calc e t c M DA Measurements per Disk Activity The number of measurements stored tem porarily in memory before written on the log file This can give you an idea of how many...

Page 94: ...1st and 2nd buttons will toggle between other available math functions Key Action Left Right Up Down Move around the keypad Mode Select a button Long Mode Calculate On Off Quit 10 4 3 Chess Clock Figure 10 37 Chess Clock The chess clock plugin is designed to simulate a chess clock but it can be used in any kind of game with up to ten players THE ROCKBOX MANUAL ARCHOS ONDIO ...

Page 95: ...fferent Keys are as follows Key Action On Off Exit plugin Left Restart round for the current player Right Pause the time press again to continue Up Switch to next player Down Switch to previous player Mode Open menu Right to select From the menu it is possible to delete a player modify the round time for the current player or set the total time for the game When the round time is up for a player t...

Page 96: ...ash Warning Image ignored Firmware flash Use when flashing Rockbox see section page In the ideal case you ll need this tool only once For safety reasons you may wish to delete firmware flash rock from rockbox rocks once flashing is complete 10 4 6 Keybox Keybox is an encrypted password storage using the Tiny Encryption Algorithm with a key derived using md5 Using Keybox To get started start up the...

Page 97: ...em in the list i e CDs will cause everything in the CDs directory to be ignored If you just want CDs to be ignored but want to include the folders within it you need to have both CDs and CDs as entries Edit Folder List Enter the folder list editor Export List To Textfile Exports the list to rockbox folder advance list txt Import List From Textfile Imports the list from rockbox folder advance list ...

Page 98: ...ow will appear Figure 10 38 The Split Editor s Main Screen The Split Editor s Main Screen The waveform displays the volume of the song over time It will appear as the song plays and help to visually identify the point in time where the split is desired The split point indicator is a vertical line with a small triangle at the top end It is the most important control element of the split editor It c...

Page 99: ...or the desired point at which to split the recording Playback loops from the split point indicator to the end of the visible area This mode is best used when fine tuning the split indicator position at the beginning of a recording Playback loops from the beginning of the visible area to the split point This mode is best used when fine tuning the split indicator position at the end of a recording P...

Page 100: ...ls in the save dialogue Scale The values in the waveform are scaled according to the settings of the peak meter These can be altered in the peak meter settings see section 7 5 page 49 If extreme minimum or maximum values are set the waveform might be cut off A minimum setting of 60 dB and a maximum setting of 0 dB are recommended These settings should be capable of producing useful waveforms for v...

Page 101: ...ished 10 4 10 Stopwatch Figure 10 41 Stopwatch A simple stopwatch program with support for saving times Key Action On Off Quit Plugin Right Start stop Left Reset timer only when timer is stopped Mode Take lap time Up Down Scroll through lap times 10 4 11 Text Editor This plugin allows you to view and edit simple text documents on your DAP You can view files by using OPEN WITH from the CONTEXT MENU...

Page 102: ...time using the VIRTUAL KEYBOARD see section 4 1 3 page 21 Move the selection bar to the line you want to edit Edit the highlighted text line or insert a new one using the Item Menu When finished editing exit the Text Editor You ll be shown a list of save options Note When you have not changed the file the Text Editor will quit immediately b Key Action Right Edit Line Select Character Left or On Of...

Page 103: ...nd in the tools directory of the Rockbox source code 11 1 3 Loading Languages Rockbox can load language files at runtime Simply copy the lng file do not use the lang file to the player and play it in the Rockbox directory browser or select SET TINGS GENERAL SETTINGS LANGUAGES from the MAIN MENU Note If you want a language to be loaded automatically every time you start up it must b be located in t...

Page 104: ...for example Notepad in Windows 2000 or XP but not in 9x ME can do this See appendix section B page 114 for all the tags that are available All characters not preceded by are displayed as typed Lines beginning with are comments and will be ignored Maximum file size used is 1600 bytes If you have a bigger WPS file only the first part of it will be loaded and used Note Keep in mind that your player r...

Page 105: ...time alternating con tinuously through each defined subline Items on a line are broken into sublines with the semicolon character The display time for each subline defaults to 2 seconds unless modified by using the t tag to specify an alternate time in seconds and optional tenths of a second for the subline to be displayed Subline related special characters and tags Split items on a line into sepa...

Page 106: ...e various ways of displaying images 1 Load and always show the image using the x tag 2 Preload the image with xl and show it with xd This way you can have your images displayed conditionally Example on bitmap preloading and use EXAMPLE x a static_icon bmp 50 50 xl b rep off bmp 16 64 xl c rep all bmp 16 64 xl d rep one bmp 16 64 xl e rep shuffle bmp 16 64 mm xdb xdc xdd xde Four images at the same...

Page 107: ...u use the SAVE CFG FILE option to create the file you can edit the file on your computer using any text editor program See Appendix section C page 121 for available settings Configuration files use the following formatting rules 1 Each setting must be on a separate line 2 Each line has the format setting value 3 Values must be within the ranges specified in this manual for each setting 4 Lines sta...

Page 108: ... exit back to the MANAGE SETTINGS menu See the WRITE CFG FILES option on the MANAGE SETTINGS menu for details of how to save and edit a configuration file Reset Settings This wipes the saved settings in the player and resets all settings to their default values Save cfg File This option writes a cfg file to your player s disk The configuration file has the cfg extension and is used to store all of...

Page 109: ...ng Flashing your player is somewhat dangerous like programming a mainboard BIOS CD DVD drive firmware mobile phone etc If the power fails the chip breaks while programming or most of all the programming software malfunctions you ll have a dead box We take no responsibility of any kind you do that at your own risk How ever we tried as carefully as possible to bulletproof this code There are a lot o...

Page 110: ...er Select SYSTEM DEBUG KEEP OUT DUMP ROM CONTENTS You ll notice a few seconds of disk activity When you connect your player to the PC afterwards you ll find two files in the root of your player Copy the 256KB sized file named internal rom 2000000 203FFFF bin to a safe place Flashing 1 Download the correct package for your player from http download rockbox org bootloader archos It is named flash mo...

Page 111: ... you want to use and unzip it to the root of your player Safely disconnect USB 2 ROLO into the new rockbox version 3 Go to the file browser and enter the rockbox directory you might need to set the FILE VIEW option to ALL 4 Play the file rockbox ucl and follow the instructions The plugin handling this is rockbox flash a viewer plugin 11 5 5 Restoring the Original Flash ROM Contents In case you eve...

Page 112: ...APPENDIX A FILE FORMATS 112 THE ROCKBOX MANUAL ARCHOS ONDIO ...

Page 113: ...e Rockbox firmware ajz ROLO will load the new firmware While Playing Screen wps The new WPS display configuration will be loaded Language File lng Loads a language file Text File txt This will display the text file using Rockbox text browser plugin Configuration File cfg The settings file will be loaded Font fnt This font will replace the current one Plugin rock Starts a Rockbox plugin Flash Image...

Page 114: ...e noted on their own line B 2 ID3 Info Tag Description ia ID3 Artist ic ID3 Composer id ID3 Album Name ig ID3 Genre Name in ID3 Track Number it ID3 Track Title iv ID3 Version 1 0 1 1 2 2 2 3 2 4 or empty if no id3 tag iy ID3 Year Remember that this information is not always available so use the conditionals to show alternate information in preference to assuming THE ROCKBOX MANUAL ARCHOS ONDIO ...

Page 115: ... Info Tag Description fb File Bitrate in kbps fc File Codec e g MP3 or FLAC This tag can also be used in a conditional tag fc mp1 mp2 mp3 aiff wav vorbis flac mpc a52 wavpack alac aac shn sid adx unknown The codec order is as follows MP1 MP2 MP3 AIFF WAV Ogg Vorbis OGG FLAC MPC AC3 WavPack WV ALAC AAC Shorten SHN SID ADX NSF Speex SPC APE ff File Frequency in Hz fm File Name fn File Name without e...

Page 116: ... Peak Meter The entire line is used as volume peak meter pn Playlist Name Without path or extension pp Playlist Position pr Remaining Time In Song ps Shuffle Shows s if shuffle mode is enabled pt Total Track Time pv Current volume x dB Can also be used in a conditional pv 0 1 2 N B 6 Runtime Database Tag Description rp Song playcount rr Song rating 0 10 This tag can also be used in a conditional t...

Page 117: ... Repeat mode 0 4 in the order Off All One Shuffle Example mm Off All One Shuffle A B B 9 Playback Mode Tags Tag Description mp Play status 0 4 in the order Stop Play Pause Fast forward Rewind Example mp Stop Play Pause Ffwd Rew THE ROCKBOX MANUAL ARCHOS ONDIO ...

Page 118: ...rockbox and including bmp x x coordinate y y coordinate nimages optional number of sub images tiled vertically of the same height contained in the bitmap Default is 1 xdn i Display a preloaded image n image ID a z and A Z as it was specified in x or xl i optional number of the sub image to dis play a z for 1 26 and A Z for 27 52 By de fault the first i e top most sub image will be used Examples 1 ...

Page 119: ...rdinates must repect each of the players limits B 11 Alignment Tag Description al Text is left aligned ac Text is center aligned ar Text is right aligned All alignment tags may be present in one line but they need to be in the order left center right If the aligned texts overlap they are merged B 12 Conditional Tags Tag Description xx true false If Else Evaluate for true or false case xx alt1 alt2...

Page 120: ...Display a s Indicate that the line should scroll Can occur anywhere in a line given that the text is displayed see conditionals above You can specify up to 10 scrolling lines Scrolling lines can not contain dynamic content such as timers peak meters or progress bars THE ROCKBOX MANUAL ARCHOS ONDIO ...

Page 121: ...skip 5s 15s 30s 1min 2min 3min 5min 10min N A volume fade on off N A id3 tag priority v2 v1 v1 v2 N A sort case on off N A show files all supported music playlists N A show filename exts off on unknown view all N A follow playlist on off N A playlist viewer icons on off N A playlist viewer indices on off N A playlist viewer track display track name full path N A recursive directory insert on off a...

Page 122: ...iles in dir 50 10000 N A lang path filename lng N A wps path filename wps N A autocreate bookmarks off on N A autoload bookmarks off on N A use most recent bookmarks off on N A pause on headphone unplug off pause pause and resume N A rewind duration on pause 0 to 15 seconds disable autoresume if phones not present off on N A Last fm Logging off on N A talk dir off number spell N A talk dir clip of...

Page 123: ...or statusbar on off N A scrollbar on off N A volume display graphic numeric N A battery display graphic numeric N A font path filename fnt N A kbd path filename kbd N A invert on off N A flip display on off N A selector type pointer bar inverse N A show icons on off N A iconset path filename bmp N A viewers iconset path filename bmp N A rec quality 0 to 7 0 small size 7 high quality rec frequency ...

Page 124: ...APPENDIX C CONFIG FILE OPTIONS 124 THE ROCKBOX MANUAL ARCHOS ONDIO ...

Page 125: ...did and what happened Whether the problem is repeatable or a one time occurrence All relevant data regarding the problem such as playlists MP3 files etc IMPOR TANT D 2 Feature ideas To suggest an idea for a feature or to read those made by others see http forums rockbox org index php board 49 0 Please keep in mind that this forum is for the dis cussion of feature ideas they are not requests and th...

Page 126: ... slow for this daunting task Archos Multimedia support The Archos Multimedia is a completely different beast It is an entirely differ ent architecture different CPU and upgrading the software is done a completely different way We do not wish to venture into this Others may do so We will not Multi band or graphic equaliser We cannot access information for that kind of visualisation from the MP3 dec...

Page 127: ... need for any good communi cation to work Support other file systems than FAT32 like NTFS or ext2 or whatever No Rockbox needs to support FAT32 since it can only start off a FAT32 partition since that is the only way the ROM can load it and addingsupport for more file systems will just take away valuable ram for unnecessary features You can partition your player fine just make sure the first one i...

Page 128: ... 2007 08 03 iPod 3rd gen is now officially a supported target 2007 08 02 Superdom game 2007 07 27 Sound on iPod 2nd Gen 2007 07 25 Jackpot support for bitmap targets 2007 06 30 Reversi game 2007 06 29 Rocklife plugin 2007 06 28 Maze game 2007 06 17 Custom filetype colour feature introduced 2007 05 23 The 80GB Ipod Video is now supported by Rockbox 2007 04 09 WAV file viewer 2007 03 11 Sound on the...

Page 129: ...n the iAudio X5 X5L and X5V 2006 03 26 Experimental WAV playback plugin for Archos Recorder Ondio 2006 03 26 Initial version of Tag Cache 2006 03 20 Bubbles a bubble game 2006 03 19 Tetrox a Tetris clone 2006 03 12 Xobox a Xonix Qix clone 2006 03 11 Pacbox a pacman arcade machine emulator 2006 02 22 Chessbox chess game plugin 2006 02 13 iPod 5G audio playback 2006 01 28 Color bitmap support in the...

Page 130: ...09 02 Enhanced statusbar in recording screen 2006 08 15 Support for displaying the path in the file browser 2006 02 07 Equalizer configuration for software codec platforms 2006 02 06 The Rockbox manual is available in L A TEXformat 2005 12 05 New wps added Engineeer2 marquee and DancePuffDuo E 1 3 New codecs supported Lossy codecs Ogg vorbis MPC A 52 AC3 AAC MP4 WMA ADX Speex Lossless codecs WAV A...

Page 131: ...AMIN METZLER FREDERIC DANG NGOC PIERRE DE LORE HUW SMITH GARRETT DERNER BARRY MCINTOSH LESLIE DONALD SON LEE PILGRIM ZAKK ROBERTS FRANCOIS BOUCHER MATTHIAS WIEN TAPPER BRENT COUTTS JENS ARNOLD GERALD VANBAREN CHRISTI SCARBOR OUGH STEVE CUNDARI MAT HOLTON JAN GAJDOS ANTOINE CELLERIER BRIAN KING JIRI JURECEK JACOB ERL BECK JEAN PHILIPPE BERNARDY DAVE HOOPER JONAS HA GGQVIST THOM JOHANSEN RINAT ZAKIR...

Page 132: ...PER THILO ALEXANDER GINKEL ADAM GASHLIN ROBERT KUKLA DAVID QUE SADA JARED STAFFORD MARTIN HENSEL STE PHANE DOYON AUSTIN APPEL AN DRE SMITH TRAVIS HYYPPA IAN WEBBER PAVEL GNELITSA LUTZ BO HNE WILL ROBERTSON ROBERT CARBONEAU YE WEI BRYAN CHILDS MIKE SCHMITT CHRIS TAYLOR TOBIAS LANGHOFF STEVE GOTTHARDT GREG WHITE MATTIEU FAVRE AUX MALCOLM TYRRELL PIOTR JAFISZOW GARY ALLEN JOHN BOUAN TOUN TOMASZ MON J...

Page 133: ...MAR TIN RITTER JUSTIN HANNIGAN TOMASZ WASILCZYK KENJIRO ARAI JOHN KAM INAR JORIS GOOSEN MARK GANSON DAVIDE GENTILE JAMES VASILE MO HAMED TAREK MIKE BURKE MICHAEL CHICOINE MACIEJ ADAMCZAK TOMER SHALEV THIBAUT GIRKA RASMUS RY WILLIAM POETRA YOGA HADISOESENO ADRIAN OSOIANU MARTIN PAHL ORI AVTALION THOMAS SCHOTT DENNIS IVANOV TAKUMI SUZUKI SHUNSUKE SHIMIZU TADAYUKI NISHIZONO JUN GU DANIEL WECK CLE MEN...

Page 134: ...License which is a copyleft license designed for free software We have designed this License in order to use it for manuals for free software because free software needs free documentation a free program should come with manuals providing the same freedoms that the software does But this License is not limited to software manuals it can be used for any textual work regardless of subject matter or ...

Page 135: ... specification is available to the general public that is suitable for revising the document straightforwardly with generic text editors or for images com posed of pixels generic paint programs or for drawings some widely available draw ing editor and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters A copy made...

Page 136: ... lend copies under the same conditions stated above and you may publicly display copies 3 COPYING IN QUANTITY If you publish printed copies or copies in media that commonly have printed covers of the Document numbering more than 100 and the Document s license notice requires Cover Texts you must enclose the copies in covers that carry clearly and legibly all these Cover Texts Front Cover Texts on ...

Page 137: ...me title as a previous version if the original publisher of that version gives permission B List on the Title Page as authors one or more persons or entities responsible for authorship of the modifications in the Modified Version together with at least five of the principal authors of the Document all of its principal authors if it has fewer than five unless they release you from this requirement ...

Page 138: ...ion includes new front matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document you may at your option designate some or all of these sections as invariant To do this add their titles to the list of Invariant Sections in the Modified Version s license notice These titles must be distinct from any other section titles You may add a section En...

Page 139: ...her documents released under this License and replace the individual copies of this License in the various doc uments with a single copy that is included in the collection provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects You may extract a single document from such a collection and distribute it individ ually under this License p...

Page 140: ...ense or dis tribute the Document is void and will automatically terminate your rights under this License However parties who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 10 FUTURE REVISIONS OF THIS LICENSE The Free Software Foundation may publish new revised versions of the GNU Free Documentatio...

Page 141: ...ariant Sections Front Cover Texts and Back Cover Texts replace the with Texts line with this with the Invariant Sections being LIST THEIR TITLES with the Front Cover Texts being LIST and with the Back Cover Texts being LIST If you have Invariant Sections without Cover Texts or some other combination of the three merge those two alternatives to suit the situation If your document contains nontrivia...

Page 142: ...need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights These restrictions translate to certain responsibilities for you if you distribute copies of the software or if you modify it For example if you distribute copies of such a program whether gratis or for a fee you must give the recipients all the rights that you have You must make sure that t...

Page 143: ... appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty keep intact all the notices that refer to this License and to the absence of any war ranty and give any other recipients of the Program a copy of this License along with the Program You may charge a fee for the physical act of transferring a copy and you may at your option offer warranty protection in ex...

Page 144: ... under the scope of this License 3 You may copy and distribute the Program or a work based on it under Section 2 in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following a Accompany it with the complete corresponding machine readable source code which must be distributed under the terms of Sections 1 and 2 above on a medium customar...

Page 145: ...his License to do so and all its terms and conditions for copying distributing or modifying the Program or works based on it 6 Each time you redistribute the Program or any work based on the Program the recipient automatically receives a license from the original licensor to copy distribute or modify the Program subject to these terms and conditions You may not impose any further restrictions on t...

Page 146: ...se from time to time Such new versions will be similar in spirit to the present version but may differ in detail to address new problems or concerns Each version is given a distinguishing version number If the Program specifies a version number of this License which applies to it and any later version you have the option of following the terms and conditions either of that version or of any later ...

Page 147: ...ublic the best way to achieve this is to make it free software which everyone can redistribute and change under these terms To do so attach the following notices to the program It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty and each file should have at least the copyright line and a pointer to where the full notice is found one lin...

Page 148: ... w and show c they could even be mouse clicks or menu items whatever suits your program You should also get your employer if you work as a programmer or your school if any to sign a copyright disclaimer for the program if necessary Here is a sample alter the names Yoyodyne Inc hereby disclaims all copyright interest in the program Gnomovision which makes passes at compilers written by James Hacker...

Reviews: