====================
pspHBSortTool v1.1.2
====================

1. Main Instructions
2. Additional Items/Tools/Notes
3. Changes Made To Source Files/Folders

Please also view the readMe.txt file.



______________________________________________________________________________
1. INSTRUCTIONS:

  o   There is no installation required for this application.
      - simply double-click the EXE to launch the tool.

  o   Upon loading, the app will search for a PSP drive on a best guess basis.
      - you can select your own drive choice from the "PSP Drive" DDL if this
        search is unsuccessful.

  o   Upon drive selection, the app will load the relevant information from
      the ISO, GAME, GAME150 and GAME5XX folders. In particular, the system
	  will check for CAT_** folders, and mark the information appropriately.
	  - "GAME5XX" can be changed - see below reference to INI file.

  o   The information can be reset/reloaded by clicking Reload, and will
      automatically be reloaded when selecting a different drive. A reload
	  will also be prompted by a significant action, such as moving items
	  between categories.

  o   Using the "Categories" DDL you can view all recognised HB items grouped
      by category. The category list is created by merging from the various
	  source folders (as they are by the plugin), and each can be sorted:
      + manually - using Up/Down buttons, or by drag'n'drop;
      + in bulk - by clicking column headers.

  o   Multiple changes can be made by switching between the categories as they
      are retained in memory until "Reload" or "Save Changes" is clicked.
      - you can also sort everything at once using the "{All Items}" category.

  o   When you're ready simply click "Save Changes" to make the necessary
      changes to the source files/folders (see below).
      - to "cancel" changes, simply "Reload".

That's pretty much it!!



______________________________________________________________________________
2. ADDITIONAL ITEMS/TOOLS/NOTES:

There are a couple of extra items/tools:

(a) "Target Content Browser"

    The plug-in's "content browser" mode uses different file/folder values to
    organise the display. This seems to be a function of the way the PSP works
	and, I guess, is unlikely to change anytime soon. Thus there is a "Target
	Content Browser" checkbox which allows you to target this method of
	sorting. Details of the differences are below.

(b) "Sort Categories"

    There is a built-in mini-version of the tool which can sort the categories
	themselves. This is launched via the "Sort Categories" button. Please note
	that in content browser mode the categories will always be displayed on
	the PSP alphabetically - so this button is disabled in this mode.

(c) The "warning" column

    I have noticed that with long filenames the addition of the category
	folder name sometimes means the PSP does not display the HB item. So I
	added a threshold warning marker which simply displays a "X" if the
	combined name gets too long. Strangely it seems the threshold value is not
	totally fixed but can vary (with the combination of category length and
	ISO filename length) so I made the threshold value changeable via a tool
	under menu option "Settings >> Adjust Warning Level" (also see the INI
	section below).

(d) The "size" column

    The default setting is for this to calculate the entire size of a HB
	folder rather than just show the size of the Eboot file as this gives a
	more accurate representation of the used space on the drive. However, if
	the HB is formed of lots of small files the size calculation can become
	slow and get annoying. Hence there is a setting to switch this off and
	show the size of just the Eboot file under menu option "Settings >>
	Eboot Size" (also see INI section below).

	ISO files are, of course, always shown as single files.

	A value of 0 specifically means "no Eboot was found" - very small values
	(<1mb) are rounded to 1mb for display. All other values are rounded down.

(e) INI files

    The system uses simple defaults - but there is an option to persist
	preferences via an INI file. You have to manually create one (using menu
	item "Settings >> Save Settings To INI File") but once one exists the
	values will update automatically.

	The INI file is created in the same folder as the app EXE.

	The following values can be understood:
    o  WarningLength - defaults to 60 (max 99, min 9)
        + this stores the preferred value for the "filename length warning";
    o  GameFolder - defaults to "GAME5XX"
        + this is to allow an element of future-proofing.
    o  Target - defaults to "ContextMenu"
	    + setting to "ContentBrowser" allows the targetting checkbox setting
 		  to be persisted;
    o  EbootSize - defaults to "Folder"
	    + setting to "Eboot" allows the file/folder sizing choice to be
		  persisted.

    The INI file can of course be updated manually, and is read when the app
	is loaded.

(f) "Right-Click menu"

    When you R/Click on an item in the main grid a context menu will appear
	giving three options:
    o  Change Category - allows you to move the current item between
 	   categories, or to create a new one;
    o  Edit Filename - allows you to edit the filename of the current object
	   (can be useful if the filename is too long);
    o  Reduce Filename - will automatically reduce the length of the filename
	   (+ category) to the length set by the WarningLevel value. The last part
	   of the filename becomes "[...]" to indicate a shortened name.



______________________________________________________________________________
3. CHANGES MADE TO SOURCE FILES/FOLDERS:

This tool updates various source file/folder datetimes into an order that the
PSP will correctly reflect on screen. This section briefly outlines which
values will be changed.

(a) When targetting "Multiple MS" or "Context Menu" mode(s):
  o   ISO Files: File Created Date of ISO file is updated;
  o   HB EBoots (GAME/GAME150/GAME5XX): Folder Modified Date of container is
      updated;
  o   Category Folders: Folder Modified Date of "CAT_**" folder is updated.


(b) When targetting "Content Browser" mode:
  o   ISO Files: File Created Date of ISO file is updated;
  o   HB EBoots (GAME/GAME150/GAME5XX): File Modified Date of EBOOT.PBP file
      is updated.

In addition, any actions involving moving items between categories and
editing filenames will be moving/renaming/creating files/folders on the
selected source drive.

These changes are, of course, made at your own risk.

