Semi-automated PSPlibdoc Updater

[FreePlay]

Out of boredom I made a little toolkit for generating a new psplibdoc.xml file based on the HTML files you can get from SilverSpring/moonlight's doc project.

Included in this package is the current version of the doc for 3.5x, with all the import-related pages removed (since they're not used in the libdoc). There are also example scripts that will show you how to generate input for the second stage of the toolkit, on both Windows and Linux. (Note: requires PHP.)

The second stage is easer; in Windows you can just drag+drop the generated input files onto builder.exe, or in Linux you can build a binary and run 'builder <input file name>'.

To get a current snapshot of the doc for any firmware, go to http://silverspring.lan.st/, then copy+paste the link for the firmware you want into a command prompt/shell/whatever for use with wget:

Code: Select all

wget -r <url>

It'll download to ./silverspring.lan.st/<firmware number>; copy this folder into the same place as builder/nids.php/etc, then switch to that folder run

Code: Select all

do <name of the firmware folder>

I know, I know; this is a bit garbled.

Here's an example of what I mean, for firmware 1.00. Assume that you start in the 'release' folder.

Code: Select all

wget -r http://silverspring.lan.st/1.00/index.html
mv silverspring.lan.st/1.00 .]
do 1.00
./builder 1.00.input

In Windows, use '\' instead of '/' and 'move' instead of 'mv'.

And... that should be it. Voila, you have a psplibdoc for the firmware of your choice. Example output for 3.5x is here, styled with the display stylesheet included in the SVN.

Sheesh, the explanation is a lot harder than actually doing it...

(download link, in case you missed it)

[FreePlay]

If you don't feeling like raping silverspring's bandwidth, I've pre-made all the libdocs for every firmware he has available. Get them right here.

Nota bene: if you get weird HTML stuff in the XML output (e.g. as the name of a library) it's because he has links in a couple of his pages. If you edit out the links in Notepad or something similar, it'll work fine.

---

and now that I look more closely, I notice that he doesn't list all the modules from all those firmwares... e.g. libssl.prx from 3.5x. he says he has a lot to update ;)

[jas0nuk]

Woohoo... an (unofficial) update to libdoc! :p

[KickinAezz]

The (prebuilt) XML's will be frequently updated Right?

at
http://f6y.ath.cx/pspdev/libdocs/

[FreePlay]

Well, I'm not sure how frequent it will be, but whenever SilverSpring makes some major changes (and lets me know) I'll update them.

[KickinAezz]

Would you mind cooking a Latest one for 3.71?

Thanks.

[hlide]

huh i'm looking for this libdoc builder or at least for the webpage where to find the last libdoc for each version (well i guess libdoc for fw3.70 is my priority), but any link given by FreePlay doesn't seem to work here.

[Wally]

From Freeplay's site

The original site is on a now-dead hard drive.

So he's obviously missing some stuff :)

[FreePlay]

Yeah, it's... sort of dead. I think SilverSpring probably still has it somewhere.