\********************************************************************/
/*               PSP Super Portable Calendar (pSPC)                 *\
\*         Author: Tristan Cartledge aka The Reefbarman             */
/*                                                                  *\
\* pSPC is a personal organizer system for the Playstation Portable.*/ 
/*    Designed to help you manage your day to day life on the run.  *\
\********************************************************************/


**************************
*   //Current Release//  *
**************************

Version: Beta 2

Added Features:-
----------------

Summary: In this release you are now able to add/delete diary entries for 
each date

- Diary/Note entries that can be saved/deleted to/from the Memory Stick
- Keyboard System for Text input under note entry
- Icons to display if note entry or similar is available on a certain date
- Right hand Menu System

Known Issues:-
--------------

Due to an unknown bug with catching button presses, i had to implement a
work around that introduces time delay to the input of cross/square/
triangle and circle buttons in the keyboard text input mode. This is
the only place this is a problem all other input is normal.

Also a slight delay has been introduced when changing calendars due
to the way i have currently implemented placing icons on the dates
that have notes

All of these the should be taken care of in the next release.

**************************
*       //Usage//        *
**************************

Calendar: -
-----------

- Use the D-Pad to navigate the calendars.

- Select the Month at the top by pressing UP or DOWN until the month is
highlighted and press LEFT or RIGHT to access more months and years

- Press CROSS on a date to access the menu on the right for that date and then 
using UP and DOWN to access other options, press CROSS again to select that option
press TRIANGLE to return to Calendar Navigation

- Current Selected item is green, and todays date is marked on calendar in orange.

- A small red box will appear within a date if a note is found for that date.


Notes Entry:-
-------------

Press TRIANGLE with nothing else HELD to access the right hand menu at anytime, then
using UP and DOWN to access other options and CROSS to select them.

KeyBoard System:-
-----------------

Below you will find the combinations of buttons required to use the keyboard for text
input, the current buttons PRESSED or HELD will be displayed at the bottom of the
screen as well as the options they allow. To scroll through letters press the
second button in the combination again while the first is still HELD until you have 
selected the letter you want.

Combinations:

SQUARE PRESSED = Change Case (upper case/lower case/numbers)

CIRCLE PRESSED = Backspace
L TRIGGER HELD + CIRCLE PRESSED = Backspace
R TRIGGER HELD + CIRCLE PRESSED = Backspace

L TRIGGER HELD + CROSS PRESSED = Confirm/Add Letter to print
R TRIGGER HELD + CROSS PRESSED = Confirm/Add Letter to print

L TRIGGER HELD + SQUARE PRESSED = Space
R TRIGGER HELD + SQUARE PRESSED = New Line

L TRIGGER HELD + TRIANGLE PRESSED = Symbols
R TRIGGER HELD + TRIANGLE PRESSED = More Symbols

Upper/Lower Case Combinations:

L TRIGGER HELD + UP PRESSED = ABC/abc
L TRIGGER HELD + RIGHT PRESSED = DEF/def
L TRIGGER HELD + DOWN PRESSED = GHI/ghi
L TRIGGER HELD + LEFT PRESSED = JKL/jkl

R TRIGGER HELD + UP PRESSED = MNO/mno
R TRIGGER HELD + RIGHT PRESSED = PQRS/pqrs
R TRIGGER HELD + DOWN PRESSED = TUV/tuv
R TRIGGER HELD + LEFT PRESSED = WYXZ/wyxz

Number Case Combinations:

L TRIGGER HELD + UP PRESSED = 12
L TRIGGER HELD + RIGHT PRESSED = 345
L TRIGGER HELD + DOWN PRESSED = 67
L TRIGGER HELD + LEFT PRESSED = 890


All PRESSED buttons can be held to repeat effect

Customization:-
---------------

To customize backgrounds, place custom images in /data/gfx/bg/
Images have to be in format bgJan.png, bgFeb.png, bgMar.png etc.....

**************************
*    //Installation//    *
**************************

To Install pSPC, extract the .rar file to ms0:/PSP/GAMEXXX/
making sure %__SCE__pSPC and __SCE__pSPC are under ms0:/PSP/GAMEXXX/
where GAMEXXX is the Game folder referring to your version of firmware

For Firmware 1.5: GAME
For Firmwares 2.71SE/3.02OE/3.03OE (any revision): GAME150 (GAME if you have set the kernel to 1.5)


**************************
*   //Future Releases//  *
**************************

Planned Features:-

- Reminders/Alarm & intergrated XMB Reminders/Alarm system
- Picture Drawing
- Phone & Address Book
- To Do Lists
- shopping Lists
- Budget Calculator
- Customizable Themes
- Document Reader
- Calculator
- Personalized Configuration
- Synchronization and BackUP with PC/MAC
- and many more

**************************
* //Previous Releases//  *
**************************

Bug Fixes:-
 
- Leap Year Properly accounted for

Added Features:-

Summary: The beginnings of an organizer, an interactive Calendar.

- Dynamic Calendar Generation meaning no matter the year the calendar is always right.
- Current Date and Time Display
- Today marked on Calendar
- Calendar Navigation
- Customizable Backgrounds

Known Bugs: none yet


**************************
*  //Developers Diary//  *
**************************

- Beta 2: Took a lot longer than i had anticipiated due to me deciding to develop my own keyboard
system, which i feel was the best decision to make as it intergrates exactly the way i want it to
within the program, i was also delayed by a bug plaguing me with in the keyboard system. The
bug i found was that if any buttons are being held down the CROSS/TRIANGEL/SQUARE/CIRCLE buttons
wont register if they are being pressed they only register if they are being held, i believe this
has something to do with the library(OSLib) im using to handle the controls of my program, instead
of using the sony standard functions. So now im trying to figure out how to use the sony functions
to have code only run once per button press, with no repeat what so ever, but no luck yet, if anyone
knows how to do this send me an email otherwise ill keep trying until i sort it out. 

The way i coded the keyboard system in its own header/source files and how it is configured will
allow me to use it in any situation/program i need it for as it is so compact and all it displays
can be reposition to where ever i liek with out changing the code itself, so in the future
im planning on releasing it as a seperate project for use by anyone who is interested once i get
the bugs sorted that is.

- Beta 1: I have had a few people ask me why they can only see this year and next and that is only
due to a limit i have placed on the gerneration of calendars so it doesn't take too long
and so there isnt too much of a problem of getting lost in the calendars, in future versions
i will set configutration options that let you configure how many years you want to see
as well as a jump to current day button so you dont get lost.

Have Fun

-ReefBarman


**************************
*     //Contact Me//     *
**************************

If you find any bugs/have any suggestions or would like to help with graphics and readme files 

please email me at 

tristan.cartledge@jcu.edu.au

**************************
*     //Donations//      *
**************************

I have had a few people contact me saying they would like to donate money to see this project
finished and have a few of their ideas maybe implemented, well if you too would like to donate
to keep pSPC on its feet and coming out with regulars updates donate to:

Using PAYPAL:

Send Donations to tristan.cartledge@jcu.edu.au

Other Methods:
Email me and we can organise alternate methods

All donations big and small are greatly appreciate and will help towards making pSPS one hell of a program

**************************
*      //Credits//       *
**************************

My Thanks goes out to:

- The guys from the forums at http://www.psp-hacks.com/forums, http://www.psp-haxors.com/forums and http://forums.ps2dev.org/
for their motivation, inspiration and support

- Everyone from http://www.psp-hacks.com/ and http://www.psp-haxors.com/ for the getting pSPC out there and in the world

- Everyone who sent me an email/donated and gave me their support/suggestions and bugs

THANK YOU EVERYONE

- Background Images Courtesy of http://www.plasmadesign.co.uk/