[Pjbexploder-announce] pjbExploder 1.0.34 released.

[Michael H. <mi...@ho...>]

This is version 1.0.34 of pjbExploder, release date Dec 25, 2003.
Merry Christmas, yadda yadda yadda.

Updating to this release is not urgent - if 1.0.33 does everything you
need, stick with it if you like.

This is a minor update that includes the following changes:

 - Fix crash during rip if FreeDB is disabled			(MDH)
 - Fix problem during sync with false duplicates		(MDH)
 - Add .M3U (playlist) files at the 'Set' level			(MDH)
 - Add 'pjbExploder.ini' control for sync
(MDH)

The first two are minor bug fixes.  The third extends the ability of
pjbExploder to create playlist files when syncing *from* the PJB *to*
the computer - playlists will now be created for entire sets as well
as discs.

The last is an improvement to the 'Sync' commands.  It provides a
means to control what directories and files are processed during
'Sync', so that the user can easily limit what files are sent to the
PJB.  It can also be used with multiple PJB's, so that each PJB ends
up with a different set of music.

Even with just one PJB, it easily allows the user to specify what
music to send to the PJB, so that if you have more music than your PJB
can handle, or wish to exclude certain directories or tracks, you can
now do so.

Since the pjbExploder help is still somewhat embryonic (i.e., doesn't
have anything useful in it yet), the notes on the format of the
'pjbExploder.ini' file are included below.

Questions? Comments?  Feel free to send them to me directly, or to the
PJB mailing list.

This is available for download 'in the usual place':
http://sourceforge.net/project/showfiles.php?group_id=87114
(or http://tinyurl.com/w6iq if mangled)

Downloads available:
ExploderSetup-1.0.34.exe		Full setup.
pjbExploder-1.0.24.zip			Binaries only
pjbExploder-1.0.34.pdb.zip		Debugging symbols
pjbExploder-1.0.34.src.zip		Full source code
pjbExploder-1.0.34.help.src.zip	Helpfile source code
pjbExploder-1.0.34.Utils.src.zip	Useful stuff for building

The helpfile source is a subset of the full source code.  If you'd
like to help create help content, this is the one to use.

The utils provide command line build scripts, and the bits required to
create a full release (including the setup program).

     Michael H.


<<<  Notes on the pjbExploder.ini file format. >>>

;;;  File should be called 'pjbExploder.ini'.

; This file is used to control how pjbExploder reads files for the
; 'Sync' process.  It provides information about what files and
; directories to include or exclude during the file search phase.

; Comments may be made by beginning any line with the ';' character.
; In general, *whitespace is important*.  "PJB =" is *not* the same as
; "PJB=", and extra spaces will make an entry invalid.  However,
; whitespace at the beginning of the line will be ignored.  Everything
; is case-insensitive.

; Values specified here apply *only* to the directory that this file
; lives in.  Child directories do *not* inherit these values - child
; directories would have to have their own 'pjbExploder.ini' files!

;;;

; If this file is empty, or does not exist, then it is equivalent to
; the following entries:

Include=*.*

;  This in turn is equivalent to the following:
PJB=default
Include_dirs=*.*
Include_files=*.*

; This is used for any PJB that is not otherwise specified in this
; file.

;;;

;; The following keywords are supported:
PJB=

Include=
Include_dirs=
Include_files=

Exclude=
Exclude_dirs=
Exclude_files=

;;

; The 'PJB=' keyword specifies that the values following it apply only
; to the specified PJB(s), until the next 'PJB=' keyword is found.  If
; a PJB is specified more than once (for example, by both name and
; address, or by using its name more than once), then the values
; accumulate.

; If you only have one PJB, then the PJB keyword is not needed.  You
; may leave it out completely (which is the same as 'PJB=Default'),
; and all entries will apply to your PJB.

; The 'PJB=' keyword can take on the following literal values:
PJB=default
PJB=all

; The 'default' values are used for any PJB that is not otherwise
; listed in the INI file.  If the PJB is specified in any other way,
; then the 'default' values are not used at all.  Any values that
; appear before the first 'PJB=' keyword are assigned as if
; 'PJB=default' was the first line in the file.

; The 'all' values apply to *all* PJB's ever connected to the system,
; regardless of any other specifications.  PJB's otherwise specified
; will *add* to the values that appear for 'all'.  Note that having
; both 'PJB=default' and 'PJB=all' will cause the 'PJB=default' values
; to be ignored!

; Or, you can specify a certain PJB using either the PJB's name (as
; displayed when the PJB boots), or the PJB's serial number (as found
; under menu 'pjb / Info on PJB...').  The names must be specified
; *exactly* as they appear in the PJB, except that the names are
; case-insensitive.

PJB=Michael's PJB
PJB=michael's pjb
PJB=010203302600

;;

; The "Include" keywords specifies which files and directories to
; include in the search.  Note that matches are made against the file
; names and directory names, *not* against the track names.  Wildcards
; ('*', etc) are supported, and multiple entries may be used.  To
; specify different values for directories and files, use the
; 'Include_dirs=' and 'Include_files="' keywords instead.  The values
; for all three accumulate until the next 'PJB=' keyword is found.

; Order is not important.  It is also OK to have the same entry twice,
; or to have a given file or directory 'found' by two different
; entries - duplicates will be detected and removed.

; If none of the 'Include' keywords is specified, then the default is
; 'Include=*.*'.

Include_dirs=The Police
Include_dirs=Sting
Include_dirs=*Tom Petty*

;;

; The "Exclude" keywords allow you to exclude directories or files.
; Generally, the files and directories found by the current "Include"
; keywords are then matched against the "Exclude" keywords, and only
; those that do not match *any* "Exclude" keyword are used.

; Values using 'Exclude=' apply to both files and directories.  If for
; some reason you want to be more specific, you can use
; 'Exclude_Dirs=' and 'Exclude_Files='.

; Wild cards are *not* supported for the "Exclude" keywords!  You must
; specify exactly (except for case) each item you want excluded!  For
; files, the excluded names are matched against both with and without
; the file extension, i.e. specifying the file extension is optional.

; If none of these keywords is specified, the default is no entries -
; no exclusions.

Exclude=Ladysmith Black Mambazo
Exclude_dirs=Marilyn Manson
Exclude_Files=Garbage_01_Supervixen.mp3
Exclude_Files=Garbage_04_As Heaven Is Wide



;;;;

; Here is an example pjbExploder.ini, as I use it.  I have two PJB's
that I
; connect, one with everything, one with much less music on it.  This
INI file
; is located at the root of all my music, which is organized by artist,
then by
; album.


PJB=MHo...@ho...
Exclude_Dirs=test

PJB=020005100263
Include_dirs='weird al' yankovic
Include_dirs=10,000 maniacs
Include_dirs=abba

;;  More directories listed here, but not shown in this example.

Include_dirs=the mamas & the papas
Include_dirs=the royal philharmonic orchestra
Include_dirs=tori amos