+----------------------+
| uo_Ograniser  v0.9.1 |
+----------------------+

Program Information
===================
Official Website: http://hoshizora.tripod.com/uo_ograniser
    Release Date: 2006.08.03
      Powered by: LUA Player 0.20 MOD 2


User Guide
==========

Introduction
------------
uo_Ograniser is an 'UnOfficial' homebrew version that extends the core
functionalities of the original program developed and released by modsyn (named
Ogranise**). This version allows you to do more things like sorting homebrew
titles automatically in alphabetical ascending or descending order, removing or
restoring corrupted data icons from the XMB menu via a 3-way folder name
inter-conversion scheme, ignoring titles you do not wish to repair in the list,
and generating a summary report at the end of the repair operation. This is
currently the only one which does it on the PSP without a USB connection.

What's New In This Release?
---------------------------
Well, COMPATIBILITY is the keyword in this latest release of uo_Ograniser!
Without further ado, here's a rundown of the new features:

I guess the most highly anticipated and requested feature is this: Added
support to iR Shell users by introducing a compatible folder name scheme! Yes,
iR Shell users can now fully enjoy uo_Ograniser as it was originally intended:
To hide corrupted data icons in the XMB menu by doing it all via the PSP
without a USB connection, and at the same time staying compatible with the rest
of the homebrew titles! Yay!

"Repair 'em all!" was all about it in the previous versions. Hmm... maybe not
that useful if the application folder name has changed, and as the result it
fails to run. That's why this new release has an Ignore Toggle feature! You may
cross out one or more title(s) you wish to ignore from the repair list. The
paired folder names of the marked title(s) will be left untouched during the
organising (and repair) operation!

And yes, you can now take screen shots as and when you like it. The *only one
screen capture file* limitation is lifted. Yes, you may now take up to 10,000
screen shots in one go! BTW, do you really need that many? (^-^);

Unofficial vs. Original Version
-------------------------------
This homebrew-mod version is packed with many 'extra' features. To start off
with, the user interface has a facelift! This unofficial release sport a new
graphical interface, menus and backgrounds to improve the end-user experience.

You may now sort your homebrew titles automatically in alphanumerical ascending
or descending order. If you are still unsatisfied with the order arrangement,
the manual sorting (positioning) tool will allow you to place your favourite
homebrew to your favourite spot.

Say goodbye to the corrupted data icons that may show up on the XMB menu! New
feature to this mod: uo_Ograniser allows you to repair (rename) the existing
homebrew folders in your game folder automatically by removing those corrupted
data icons. This one-time process is completely safe***, you may even reverse
the process if you wish to restore the original folder names.

And finally, before you could answer 'Yes!' to begin the organising
(finalizing) process, safety checks will be kicked in to make sure your PSP
have sufficient battery life or it is plugged into an AC-adaptor before you are
allowed to perform read/write operations on your memory stick.

Of course, a progress bar indicator will show the percentage of completion
during those long organising process. Upon completion, a Summary Report will be
generated to give you an overview on the folders that were processed and each
individual success failure result.

There you go, all these features packed into one homebrew application, and this
is currently the only one which does it on the PSP without a USB connection!

Side Notes:
**Yes, the original homebrew title is spelt that way!

***Dark_AleX and several others have developed custom firmwares for 1.50 PSP.
One of the features enable you to hide corrupted data icons from the XMB menu.
Although these custom firmware mods have been tested by many users, there is
always a possibility of bricking your PSP when writing to the flash memory, so
please be careful!


Installation
============
The zip archive contains the following files and folders:
%__SCE__uo_Ograniser
__SCE__uo_Ograniser
Changes.txt
Readme.txt

Copy the folders '%__SCE__uo_Ograniser' and '__SCE__uo_Ograniser' to the GAME
folder in your PSP memory stick:
ms0:/PSP/GAME

The folder structure should look like this after the installation:
ms0:/PSP/GAME/%__SCE__uo_Ograniser
ms0:/PSP/GAME/__SCE__uo_Ograniser


Program Controls
================

Splash Screen
-------------
[SELECT]                       - Take a screenshot of the current screen and
                                 save it to the memory stick
[START]                        - Go to Edit Screen


Edit Screen (Displays FW1.0/FW1.5 Homebrew):
--------------------------------------------
The buttons are assigned to perform the following tasks:
D-pad [<]                      - Display FW1.0 Homebrew list
D-pad [>]                      - Display FW1.5 Homebrew list
[TRIANGLE]                     - Toggle sort option by reordering the list in
                                 alphanumerical ascending/descending order
				 (only in FW1.5 Homebrew screen)
[SQUARE]                       - Toggle ignore option for ALL titles to be
                                 included/excluded in the repair list (only
                                 in FW1.5 Homebrew screen)
[CIRCLE]                       - Toggle ignore option for a SINGLE title to be
                                 included/excluded in the repair list (only in
                                 FW1.5 Homebrew screen)
D-pad/Analog-stick [^]+[CROSS] - Reposition the homebrew title by moving the
                                 selection up by one title (only in FW1.5
                                 Homebrew screen)
D-pad/Analog-stick [v]+[CROSS] - Reposition the homebrew title by moving the
                                 selection down by one title (only in FW1.5
                                 Homebrew screen)
[L] trigger                    - Cycle through the following display options
                                 (only in FW1.5 Homebrew screen):
                                 * FORMATTED - Format and display the list
                                               without the extra symbols
                                 * ORIGINAL  - Display the list in its
                                               original raw form
[R] trigger                    - Cycle through the following repair options
                                 (only in FW1.5 Homebrew screen):
                                 * __SCE     - Hide the corrupted data icons in
                                               the XMB menu by renaming the
                                               folders to __SCE & %__SCE name
                                               scheme
                                 * iR Shell  - Hide the corrupted data icons in
                                               the XMB menu by renaming the
                                               folders to iR Shell compatible
                                               name scheme
                                 * F&F%      - Show the corrupted data icons in
                                               the XMB menu by renaming the
                                               folders to FOLDER & FOLDER% name
                                               scheme
                                 * ----      - No changes will be made to the
                                               folders name in the GAME folder
[SELECT]                       - Take a screen shot of the current screen and
                                 save it to the memory stick
[START]                        - Confirm screen with the option to perform the
                                 organising (or sorting if you would like to
                                 call it) task
Analog-stick [<]               - Confirm screen with the option to Quit the
                                 program or return to the Edit screen


Summary Report Screen:
----------------------
D-pad [<]                      - Display the next page of the report (if
                                 available)
D-pad [>]                      - Display the previous page of the report (if
                                 available)
[CIRCLE]                       - Return to the Summary Report screen (from the
                                 on-screen Error Codes quick reference guide)
[CROSS]                        - View the on-screen Error Codes quick reference
                                 guide
[SELECT]                       - Take a screen shot of the current screen and
                                 save it to the memory stick
[START]                        - Return to the Splash screen
Analog-stick [<]               - Confirm screen with the option to Quit the
                                 program or return to Summary Report screen


Error Codes - Quick Reference Guide
===================================
Code     Description
----     -----------
A        Error in removing a file from Shortcut folder
B        Error in reading a file from Shortcut folder
C        Error in removing the Shortcut folder
D,G,J    Error in renaming the Program folder
E,H,K    Duplicate Program folder name exists
F,I,L    Unable to find Program:Shortcut folder pair
M,N,P    Error in creating the Shortcut folder
O        Duplicate Shortcut folder name exists
Q        Error in writing a file to Shortcut folder


Credits & Feedback
==================
Special thanks goes to:
- modsyn for his initial work on the original program;
- Cools for his latest mod on the LUA Player;
- Stefano Russello for his PSP Brew;
- Exodus on the iR Shell compatibility issues and folder name scheme tip;
- Dark_AleX for his contribution to the PSP scene; and
- Angel for her support and assistance.
Suggestions? Comments? Feedbacks? Please email to hoshizora@hotmail.com


Donations
=========
This software is available to you free-of-charge. If you like this software,
please consider making a donation. You can access the PayPal Donate link from
the official website at:
http://hoshizora.tripod.com/uo_ograniser

Thank you! (^-^)/


UO_OGRANISER LICENSE AGREEMENT
==============================

NO WARRANTY
-----------
UO_OGRANISER IS DISTRIBUTED "AS IS" AND WITHOUT ANY WARRANTY AS TO
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE OR ANY OTHER WARRANTIES
EITHER EXPRESSED OR IMPLIED. THE AUTHOR WILL NOT BE LIABLE FOR DATA LOSS,
DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR MISUSING THIS
SOFTWARE.

Distribution 
------------
You may copy the freeware version of this software and documentation as you
wish, and give exact copies of the original freeware version to anyone, and
distribute the freeware version of the software and documentation in its
unmodified form via electronic means. But you should not charge or requesting
donations for any such copies however made and from distributing the software
and/or documentation with other products without the author's written
permission.