Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Tag 2.2.1, a Windows bugfix release.

  • Loading branch information...
commit d2b7b7295b1b8f743859d5531cfab7f38b9de3b5 1 parent 5690b45
@minter authored
View
142 doc/html/a850.html
@@ -0,0 +1,142 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML
+><HEAD
+><TITLE
+>Known Bugs and Issues</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
+REL="HOME"
+TITLE="Mr. Voice 2.2 Installation and Reference Manual"
+HREF="index.html"><LINK
+REL="PREVIOUS"
+TITLE="Troubleshooting and FAQs"
+HREF="c793.html"><LINK
+REL="NEXT"
+TITLE="Contributing, Contacting, and Bug Reporting"
+HREF="a854.html"></HEAD
+><BODY
+CLASS="APPENDIX"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>Mr. Voice 2.2 Installation and Reference Manual</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="c793.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="a854.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="APPENDIX"
+><H1
+><A
+NAME="AEN850"
+></A
+>Appendix A. Known Bugs and Issues</H1
+><P
+>Check the <A
+HREF="http://www.mrvoice.net/bugzilla/"
+TARGET="_top"
+>Mr. Voice Bugzilla</A
+> database for outstanding issues.</P
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="c793.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="index.html"
+ACCESSKEY="H"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="a854.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Troubleshooting and FAQs</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Contributing, Contacting, and Bug Reporting</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
View
156 doc/html/a854.html
@@ -0,0 +1,156 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML
+><HEAD
+><TITLE
+>Contributing, Contacting, and Bug Reporting</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
+REL="HOME"
+TITLE="Mr. Voice 2.2 Installation and Reference Manual"
+HREF="index.html"><LINK
+REL="PREVIOUS"
+TITLE="Known Bugs and Issues"
+HREF="a850.html"><LINK
+REL="NEXT"
+TITLE="Software License"
+HREF="a863.html"></HEAD
+><BODY
+CLASS="APPENDIX"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>Mr. Voice 2.2 Installation and Reference Manual</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="a850.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="a863.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="APPENDIX"
+><H1
+><A
+NAME="AEN854"
+></A
+>Appendix B. Contributing, Contacting, and Bug Reporting</H1
+><P
+>If you like this program, and know of a way to make it better, feel free to modify it. This software is released under the GNU General Public License, so read the COPYING file or visit <A
+HREF="http://www.gnu.org/"
+TARGET="_top"
+>the GNU project</A
+> for information on license conditions.</P
+><P
+>If you make a cool modification to this program, feel free to send a diff to me, and I'll incorporate it into the main body of the program.</P
+><P
+>Feel free to report any bugs, feature requests, etc. to me via the <A
+HREF="http://www.mrvoice.net/bugzilla/"
+TARGET="_top"
+>Mr. Voice Bugzilla</A
+>. As this is a specific-purpose project, there's no guarantee that I'll do it, but I'm glad to listen to any suggestions. Check the TODO file to see stuff I'm currently working on.</P
+><P
+>The software's home on the web is <A
+HREF="http://www.mrvoice.net/"
+TARGET="_top"
+>http://www.mrvoice.net/</A
+> - check there for any news and developments.</P
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="a850.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="index.html"
+ACCESSKEY="H"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="a863.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Known Bugs and Issues</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Software License</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
View
194 doc/html/a863.html
@@ -0,0 +1,194 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML
+><HEAD
+><TITLE
+>Software License</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
+REL="HOME"
+TITLE="Mr. Voice 2.2 Installation and Reference Manual"
+HREF="index.html"><LINK
+REL="PREVIOUS"
+TITLE="Contributing, Contacting, and Bug Reporting"
+HREF="a854.html"></HEAD
+><BODY
+CLASS="APPENDIX"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>Mr. Voice 2.2 Installation and Reference Manual</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="a854.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+>&nbsp;</TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="APPENDIX"
+><H1
+><A
+NAME="AEN863"
+></A
+>Appendix C. Software License</H1
+><P
+>This software is released under the terms of the GNU General Public License. The preamble of the license is listed below. Please see the file named <TT
+CLASS="FILENAME"
+>COPYING</TT
+> included in the Mr. Voice package for the full license, or view it online at <A
+HREF="http://www.gnu.org/licenses/gpl.html"
+TARGET="_top"
+>http://www.gnu.org/licenses/gpl.html</A
+>.</P
+><P
+CLASS="LITERALLAYOUT"
+>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;GNU&nbsp;GENERAL&nbsp;PUBLIC&nbsp;LICENSE<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Version&nbsp;2,&nbsp;June&nbsp;1991<br>
+<br>
+&nbsp;Copyright&nbsp;(C)&nbsp;1989,&nbsp;1991&nbsp;Free&nbsp;Software&nbsp;Foundation,&nbsp;Inc.<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;59&nbsp;Temple&nbsp;Place,&nbsp;Suite&nbsp;330,&nbsp;Boston,&nbsp;MA&nbsp;&nbsp;02111-1307&nbsp;&nbsp;USA<br>
+&nbsp;Everyone&nbsp;is&nbsp;permitted&nbsp;to&nbsp;copy&nbsp;and&nbsp;distribute&nbsp;verbatim&nbsp;copies<br>
+&nbsp;of&nbsp;this&nbsp;license&nbsp;document,&nbsp;but&nbsp;changing&nbsp;it&nbsp;is&nbsp;not&nbsp;allowed.<br>
+<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Preamble<br>
+<br>
+&nbsp;&nbsp;The&nbsp;licenses&nbsp;for&nbsp;most&nbsp;software&nbsp;are&nbsp;designed&nbsp;to&nbsp;take&nbsp;away&nbsp;your<br>
+freedom&nbsp;to&nbsp;share&nbsp;and&nbsp;change&nbsp;it.&nbsp;&nbsp;By&nbsp;contrast,&nbsp;the&nbsp;GNU&nbsp;General&nbsp;Public<br>
+License&nbsp;is&nbsp;intended&nbsp;to&nbsp;guarantee&nbsp;your&nbsp;freedom&nbsp;to&nbsp;share&nbsp;and&nbsp;change&nbsp;free<br>
+software--to&nbsp;make&nbsp;sure&nbsp;the&nbsp;software&nbsp;is&nbsp;free&nbsp;for&nbsp;all&nbsp;its&nbsp;users.&nbsp;&nbsp;This<br>
+General&nbsp;Public&nbsp;License&nbsp;applies&nbsp;to&nbsp;most&nbsp;of&nbsp;the&nbsp;Free&nbsp;Software<br>
+Foundation's&nbsp;software&nbsp;and&nbsp;to&nbsp;any&nbsp;other&nbsp;program&nbsp;whose&nbsp;authors&nbsp;commit&nbsp;to<br>
+using&nbsp;it.&nbsp;&nbsp;(Some&nbsp;other&nbsp;Free&nbsp;Software&nbsp;Foundation&nbsp;software&nbsp;is&nbsp;covered&nbsp;by<br>
+the&nbsp;GNU&nbsp;Library&nbsp;General&nbsp;Public&nbsp;License&nbsp;instead.)&nbsp;&nbsp;You&nbsp;can&nbsp;apply&nbsp;it&nbsp;to<br>
+your&nbsp;programs,&nbsp;too.<br>
+<br>
+&nbsp;&nbsp;When&nbsp;we&nbsp;speak&nbsp;of&nbsp;free&nbsp;software,&nbsp;we&nbsp;are&nbsp;referring&nbsp;to&nbsp;freedom,&nbsp;not<br>
+price.&nbsp;&nbsp;Our&nbsp;General&nbsp;Public&nbsp;Licenses&nbsp;are&nbsp;designed&nbsp;to&nbsp;make&nbsp;sure&nbsp;that&nbsp;you<br>
+have&nbsp;the&nbsp;freedom&nbsp;to&nbsp;distribute&nbsp;copies&nbsp;of&nbsp;free&nbsp;software&nbsp;(and&nbsp;charge&nbsp;for<br>
+this&nbsp;service&nbsp;if&nbsp;you&nbsp;wish),&nbsp;that&nbsp;you&nbsp;receive&nbsp;source&nbsp;code&nbsp;or&nbsp;can&nbsp;get&nbsp;it<br>
+if&nbsp;you&nbsp;want&nbsp;it,&nbsp;that&nbsp;you&nbsp;can&nbsp;change&nbsp;the&nbsp;software&nbsp;or&nbsp;use&nbsp;pieces&nbsp;of&nbsp;it<br>
+in&nbsp;new&nbsp;free&nbsp;programs;&nbsp;and&nbsp;that&nbsp;you&nbsp;know&nbsp;you&nbsp;can&nbsp;do&nbsp;these&nbsp;things.<br>
+<br>
+&nbsp;&nbsp;To&nbsp;protect&nbsp;your&nbsp;rights,&nbsp;we&nbsp;need&nbsp;to&nbsp;make&nbsp;restrictions&nbsp;that&nbsp;forbid<br>
+anyone&nbsp;to&nbsp;deny&nbsp;you&nbsp;these&nbsp;rights&nbsp;or&nbsp;to&nbsp;ask&nbsp;you&nbsp;to&nbsp;surrender&nbsp;the&nbsp;rights.<br>
+These&nbsp;restrictions&nbsp;translate&nbsp;to&nbsp;certain&nbsp;responsibilities&nbsp;for&nbsp;you&nbsp;if&nbsp;you<br>
+distribute&nbsp;copies&nbsp;of&nbsp;the&nbsp;software,&nbsp;or&nbsp;if&nbsp;you&nbsp;modify&nbsp;it.<br>
+<br>
+&nbsp;&nbsp;For&nbsp;example,&nbsp;if&nbsp;you&nbsp;distribute&nbsp;copies&nbsp;of&nbsp;such&nbsp;a&nbsp;program,&nbsp;whether<br>
+gratis&nbsp;or&nbsp;for&nbsp;a&nbsp;fee,&nbsp;you&nbsp;must&nbsp;give&nbsp;the&nbsp;recipients&nbsp;all&nbsp;the&nbsp;rights&nbsp;that<br>
+you&nbsp;have.&nbsp;&nbsp;You&nbsp;must&nbsp;make&nbsp;sure&nbsp;that&nbsp;they,&nbsp;too,&nbsp;receive&nbsp;or&nbsp;can&nbsp;get&nbsp;the<br>
+source&nbsp;code.&nbsp;&nbsp;And&nbsp;you&nbsp;must&nbsp;show&nbsp;them&nbsp;these&nbsp;terms&nbsp;so&nbsp;they&nbsp;know&nbsp;their<br>
+rights.<br>
+<br>
+&nbsp;&nbsp;We&nbsp;protect&nbsp;your&nbsp;rights&nbsp;with&nbsp;two&nbsp;steps:&nbsp;(1)&nbsp;copyright&nbsp;the&nbsp;software,&nbsp;and<br>
+(2)&nbsp;offer&nbsp;you&nbsp;this&nbsp;license&nbsp;which&nbsp;gives&nbsp;you&nbsp;legal&nbsp;permission&nbsp;to&nbsp;copy,<br>
+distribute&nbsp;and/or&nbsp;modify&nbsp;the&nbsp;software.<br>
+<br>
+&nbsp;&nbsp;Also,&nbsp;for&nbsp;each&nbsp;author's&nbsp;protection&nbsp;and&nbsp;ours,&nbsp;we&nbsp;want&nbsp;to&nbsp;make&nbsp;certain<br>
+that&nbsp;everyone&nbsp;understands&nbsp;that&nbsp;there&nbsp;is&nbsp;no&nbsp;warranty&nbsp;for&nbsp;this&nbsp;free<br>
+software.&nbsp;&nbsp;If&nbsp;the&nbsp;software&nbsp;is&nbsp;modified&nbsp;by&nbsp;someone&nbsp;else&nbsp;and&nbsp;passed&nbsp;on,&nbsp;we<br>
+want&nbsp;its&nbsp;recipients&nbsp;to&nbsp;know&nbsp;that&nbsp;what&nbsp;they&nbsp;have&nbsp;is&nbsp;not&nbsp;the&nbsp;original,&nbsp;so<br>
+that&nbsp;any&nbsp;problems&nbsp;introduced&nbsp;by&nbsp;others&nbsp;will&nbsp;not&nbsp;reflect&nbsp;on&nbsp;the&nbsp;original<br>
+authors'&nbsp;reputations.<br>
+<br>
+&nbsp;&nbsp;Finally,&nbsp;any&nbsp;free&nbsp;program&nbsp;is&nbsp;threatened&nbsp;constantly&nbsp;by&nbsp;software<br>
+patents.&nbsp;&nbsp;We&nbsp;wish&nbsp;to&nbsp;avoid&nbsp;the&nbsp;danger&nbsp;that&nbsp;redistributors&nbsp;of&nbsp;a&nbsp;free<br>
+program&nbsp;will&nbsp;individually&nbsp;obtain&nbsp;patent&nbsp;licenses,&nbsp;in&nbsp;effect&nbsp;making&nbsp;the<br>
+program&nbsp;proprietary.&nbsp;&nbsp;To&nbsp;prevent&nbsp;this,&nbsp;we&nbsp;have&nbsp;made&nbsp;it&nbsp;clear&nbsp;that&nbsp;any<br>
+patent&nbsp;must&nbsp;be&nbsp;licensed&nbsp;for&nbsp;everyone's&nbsp;free&nbsp;use&nbsp;or&nbsp;not&nbsp;licensed&nbsp;at&nbsp;all.<br>
+<br>
+&nbsp;&nbsp;The&nbsp;precise&nbsp;terms&nbsp;and&nbsp;conditions&nbsp;for&nbsp;copying,&nbsp;distribution&nbsp;and<br>
+modification&nbsp;follow.<br>
+&nbsp;&nbsp;</P
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="a854.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="index.html"
+ACCESSKEY="H"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>&nbsp;</TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Contributing, Contacting, and Bug Reporting</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>&nbsp;</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
View
357 doc/html/c151.html
@@ -0,0 +1,357 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML
+><HEAD
+><TITLE
+>Installing Mr. Voice</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
+REL="HOME"
+TITLE="Mr. Voice 2.2 Installation and Reference Manual"
+HREF="index.html"><LINK
+REL="PREVIOUS"
+TITLE="What's new in Version 2.0?"
+HREF="x114.html"><LINK
+REL="NEXT"
+TITLE="Installation Steps"
+HREF="x223.html"></HEAD
+><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>Mr. Voice 2.2 Installation and Reference Manual</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="x114.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="x223.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="CHAPTER"
+><H1
+><A
+NAME="AEN151"
+></A
+>Chapter 1. Installing Mr. Voice</H1
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="AEN153"
+>1.1. Required Components</A
+></H1
+><P
+> Mr. Voice currently runs under Unix-like operating systems (Linux/*BSD/etc) and Microsoft operating systems (Windows 95 or higher).
+ </P
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN156"
+>1.1.1. Microsoft Windows</A
+></H2
+><P
+>The following components are required to run Mr. Voice under Windows 95 or higher.
+ <P
+></P
+><UL
+><LI
+><P
+>An MP3 player. <A
+HREF="http://www.winamp.com/"
+TARGET="_top"
+>WinAmp</A
+> version 5 is recommended. If you plan on playing Windows Media Audio (WMA) files, you will need at least WinAmp Version 5, Full install (not "Lite")</P
+></LI
+><LI
+><P
+>The <A
+HREF="http://www.kostaa.com/winamp/index.html"
+TARGET="_top"
+>httpQ plugin</A
+> for WinAmp. <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Optional, but recommended, since it allows you to fade-stop songs.</I
+></SPAN
+></P
+></LI
+><LI
+><P
+>The <A
+HREF="http://www.mrvoice.net/files/"
+TARGET="_top"
+>Ogg Vorbis plugin</A
+> for WinAmp. <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Optional, but required if you want to play .ogg files.</I
+></SPAN
+></P
+></LI
+><LI
+><P
+>The <A
+HREF="http://www.rarewares.org/mp4.html"
+TARGET="_top"
+>AAC plugin</A
+> for WinAmp. <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Optional, but required if you want to use AAC/MP4 files</I
+></SPAN
+></P
+></LI
+></UL
+>
+ </P
+><P
+>If, for some reason, you do not want to run the prebuilt <TT
+CLASS="FILENAME"
+>mrvoice.exe</TT
+> file, and want to install all of the Perl modules that Mr. Voice requires by hand, follow the Unix/Linux instructions below and either build the modules by hand, or install the appropriate ActiveState PPM packages. But I doubt many Windows users will want to do that.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN177"
+>1.1.2. Unix/Linux/BSD</A
+></H2
+><P
+>The following components are required to run Mr. Voice under Unix systems.
+ <P
+></P
+><UL
+><LI
+><P
+><A
+HREF="http://www.perl.com/"
+TARGET="_top"
+>Perl</A
+> version 5.8 (Should be provided with most modern Unix systems), plus the following perl modules (most available from <A
+HREF="http://www.cpan.org/"
+TARGET="_top"
+>CPAN</A
+>):
+ <P
+></P
+><UL
+><LI
+><P
+><A
+HREF="http://www.cpan.org/modules/by-module/Audio/"
+TARGET="_top"
+>Audio::Wav</A
+></P
+></LI
+><LI
+><P
+><A
+HREF="http://www.cpan.org/modules/by-module/Date/"
+TARGET="_top"
+>Date::Manip</A
+></P
+></LI
+><LI
+><P
+><A
+HREF="http://www.cpan.org/modules/by-module/DBD/"
+TARGET="_top"
+>DBD </A
+> driver for your database (DBD::SQLite 1.0 and higher supported)</P
+></LI
+><LI
+><P
+><A
+HREF="http://www.cpan.org/modules/by-module/DBI/"
+TARGET="_top"
+>DBI</A
+></P
+></LI
+><LI
+><P
+><A
+HREF="http://www.cpan.org/modules/by-module/MPEG/"
+TARGET="_top"
+>MPEG::MP3-Info</A
+></P
+></LI
+><LI
+><P
+><A
+HREF="http://www.cpan.org/modules/by-module/MP4/"
+TARGET="_top"
+>MP4::Info</A
+></P
+></LI
+><LI
+><P
+><A
+HREF="http://www.cpan.org/modules/by-module/Ogg/"
+TARGET="_top"
+>Ogg::Vorbis::Header::PurePerl</A
+></P
+></LI
+><LI
+><P
+><A
+HREF="http://www.cpan.org/modules/by-module/Time/"
+TARGET="_top"
+>Time::HiRes</A
+></P
+></LI
+><LI
+><P
+><A
+HREF="http://www.cpan.org/modules/by-module/Tk/"
+TARGET="_top"
+>Tk</A
+> version 804.x (Version 800.x is unsupported as of Mr. Voice version 1.10)</P
+></LI
+><LI
+><P
+><A
+HREF="http://www.cpan.org/modules/by-module/Tk/"
+TARGET="_top"
+>Tk::ProgressBar::Mac</A
+></P
+></LI
+></UL
+>
+ </P
+></LI
+><LI
+><P
+>An MP3 player. <A
+HREF="http://www.xmms.org/"
+TARGET="_top"
+>xmms</A
+> is recommended.</P
+></LI
+><LI
+><P
+><A
+HREF="http://faac.sourceforge.net/"
+TARGET="_top"
+>AAC plugin for XMMS</A
+>. <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Optional, but needed if you want to use AAC/MP4/M4A files.</I
+></SPAN
+></P
+></LI
+></UL
+>
+ </P
+></DIV
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="x114.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="index.html"
+ACCESSKEY="H"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="x223.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>What's new in Version 2.0?</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Installation Steps</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
View
413 doc/html/c293.html
@@ -0,0 +1,413 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML
+><HEAD
+><TITLE
+>Configuring Mr. Voice</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
+REL="HOME"
+TITLE="Mr. Voice 2.2 Installation and Reference Manual"
+HREF="index.html"><LINK
+REL="PREVIOUS"
+TITLE="Installation Steps"
+HREF="x223.html"><LINK
+REL="NEXT"
+TITLE="Using Mr. Voice"
+HREF="c389.html"></HEAD
+><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>Mr. Voice 2.2 Installation and Reference Manual</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="x223.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="c389.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="CHAPTER"
+><H1
+><A
+NAME="AEN293"
+></A
+>Chapter 2. Configuring Mr. Voice</H1
+><P
+>This section will take you through configuring the Mr. Voice software. Mr. Voice is configured via an external configuration file - this provides the most flexibility in keeping your configuration sane from one version to the next. On Unix, the default config file is named <TT
+CLASS="FILENAME"
+>.mrvoicerc</TT
+>, and lives in your home directory. On Windows, the default filename is <TT
+CLASS="FILENAME"
+>C:\mrvoice.cfg</TT
+>.</P
+><P
+>To provide an alternate configuration file (for example, if you would like to run two separate databases off of the same computer), you can pass the Mr. Voice program the "--config" flag. So on Windows, if you wanted to use an alternate config file, you would run "<SAMP
+CLASS="COMPUTEROUTPUT"
+>MRVOICE.EXE --config C:\MRVOICE-ALTERNATE.CFG</SAMP
+>", or on Unix "<SAMP
+CLASS="COMPUTEROUTPUT"
+>./mrvoice.pl --config /path/to/new/configfile</SAMP
+>".</P
+><P
+>If you start Mr. Voice without a configuration file, or if there is an error in your configuration, Mr. Voice will pop up a window asking if you want to create a default or manual configuration. If you choose default, it will set up a fairly standard installation for you. If you choose manual, you will be taken to the preferences window, allowing you to enter and edit the configuration information. Changes are then written out to the appropriate configuration file. The configuration options are detailed below.
+ <DIV
+CLASS="FIGURE"
+><A
+NAME="AEN302"
+></A
+><P
+><B
+>Figure 2-1. The Preferences window</B
+></P
+><DIV
+CLASS="MEDIAOBJECT"
+><P
+><IMG
+SRC="../images/preferences.png"></P
+></DIV
+></DIV
+>
+ </P
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="AEN309"
+>2.1. Configuration Options and Variables</A
+></H1
+><P
+>The options that you can set in the <SPAN
+CLASS="GUIMENU"
+>File</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Preferences</SPAN
+> menu are listed below. After the name of each option, the actual variable name is given in parenthesis, in case you need to edit the configuration files manually (Manual configuration is detailed in section 2.1.1).</P
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN315"
+>2.1.1. Database Options</A
+></H2
+><P
+></P
+><UL
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>Database Filename (db_file)</CODE
+> - The file on your hard drive that contains the Mr. Voice SQLite database (<TT
+CLASS="FILENAME"
+>C:\mrvoice.db</TT
+> by default on Windows, <TT
+CLASS="FILENAME"
+>~/mrvoice.db</TT
+> by default on Unix)</P
+></LI
+></UL
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN323"
+>2.1.2. File Paths</A
+></H2
+><P
+></P
+><UL
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>MP3 Directory (filepath)</CODE
+> - The path information that will be prepended to the filename retrieved from the database or, in other words, the directory where you store your MP3 files. Used to find the actual MP3 files on the local system. The user who is running Mr. Voice must have read/write permission into this directory.</P
+></LI
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>Hotkey Directory (savepath)</CODE
+> - This will be the default directory that hotkey save files will go into. The user running the program as must have read/write permission into that directory. Recommended to be different than the Mr. Voice install directory.</P
+></LI
+></UL
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN332"
+>2.1.3. Search Options</A
+></H2
+><P
+></P
+><UL
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>Search ASCAP songs (search_ascap)</CODE
+> - Enables searches of songs that have ASCAP set as the publisher field. Only needed if you are using song publishers in your database.</P
+></LI
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>Search BMI songs (search_bmi)</CODE
+> - Enables searches of songs that have BMI set as the publisher field. Only needed if you are using song publishers in your database.</P
+></LI
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>Show Song Publisher (show_publisher)</CODE
+> - Enables the display of the song publisher in the search results. Only needed if you are using song publishers in your database.</P
+></LI
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>Search Other songs (search_other)</CODE
+> - Enables searches of songs that have "Other" set as the publisher field. Only needed if you are using song publishers in your database.</P
+></LI
+></UL
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN347"
+>2.1.4. Online Options</A
+></H2
+><P
+></P
+><UL
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>Enable Online Functionality (enable_online)</CODE
+> - Enable this option if you want to use any of the online functionality (such as version checks or Mr. Voice Online). If this is not enabled, you will not get the menu items that offer online functionality. Obviously, enabling this without an internet connection on your Mr. Voice computer is a bit silly.</P
+></LI
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>Check For New Versions (check_version)</CODE
+> - If enabled, will check the Mr. Voice website once a week and alert you if a new version of Mr. Voice is available.</P
+></LI
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>Mr. Voice Online key (online_key)</CODE
+> - When you register for Mr. Voice online, you will be given a key password. Enter that here, or your Mr. Voice online functionality will fail. For information on how to get a key, see the Mr. Voice Online section in this manual.</P
+></LI
+></UL
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN359"
+>2.1.5. Other</A
+></H2
+><P
+></P
+><UL
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>MP3 Player (mp3player)</CODE
+> - The path to your MP3 player. Likely options are <TT
+CLASS="FILENAME"
+>/usr/bin/xmms</TT
+> for Unix systems, and <TT
+CLASS="FILENAME"
+>C:\Program Files\WinAmp\WinAmp.exe</TT
+> for Windows systems. This option is not used on Mac OS X, as it uses AppleScript to launch the Audion MP3 player.</P
+></LI
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>Number of Dynamic Documents To Show (savefile_max)</CODE
+> - The number of "most recently accessed hotkey files" to keep available under the <SPAN
+CLASS="GUIMENU"
+>File</SPAN
+> menu. Defaults to 4.</P
+></LI
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>httpQ Password (httpq_pw)</CODE
+> - The password used to connect to the httpQ plugin for WinAmp. Only useful under Windows if you're using the httpQ plugin. Otherwise it's ignored.</P
+></LI
+><LI
+><P
+><CODE
+CLASS="VARNAME"
+>Write Access Password (write_password)</CODE
+> - If this option is set, any attempt to perform an action that will modify the Mr. Voice system (adding a song, deleting a song, renaming a category, etc) will prompt for the password (once per session).
+ <DIV
+CLASS="MEDIAOBJECT"
+><P
+><IMG
+SRC="../images/enter-password.png"></P
+></DIV
+>
+ No password, no changes. Useful if you have people running Mr. Voice that you don't trust not to break things.</P
+></LI
+></UL
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN380"
+>2.1.6. Manual Configuration</A
+></H2
+><P
+>To troubleshoot, fine-tune changes, or skip the GUI alltogether, you can manually set up the configuration file. The configuration file consists of lines in the following format:</P
+><P
+><SAMP
+CLASS="COMPUTEROUTPUT"
+>variable_name::value</SAMP
+></P
+><P
+>Where variable_name is the name in parenthesis in the configuration listing above, followed by two colons, followed by the value you want to set the variable to. A sample file on Unix would look like this:
+ <PRE
+CLASS="SCREEN"
+>db_file::/home/mrvoice/mrvoice.db
+filepath::/mp3/
+savedir::/tmp/
+mp3player::/usr/bin/xmms
+savefile_max::4
+httpq_pw::mypass
+search_ascap::1
+search_bmi::1
+search_other::1
+show_publisher::0
+ </PRE
+>
+ </P
+><P
+>The Windows <TT
+CLASS="FILENAME"
+>C:\MRVOICE.CFG</TT
+> file will look similar, but with Windows pathnames instead of Unix ones. The Mac config file (named mrvoice.cfg in your home folder) will look similar to the Unix one.</P
+></DIV
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="x223.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="index.html"
+ACCESSKEY="H"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="c389.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Installation Steps</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Using Mr. Voice</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
View
660 doc/html/c389.html
@@ -0,0 +1,660 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML
+><HEAD
+><TITLE
+>Using Mr. Voice</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
+REL="HOME"
+TITLE="Mr. Voice 2.2 Installation and Reference Manual"
+HREF="index.html"><LINK
+REL="PREVIOUS"
+TITLE="Configuring Mr. Voice"
+HREF="c293.html"><LINK
+REL="NEXT"
+TITLE="Searching and Playing Songs"
+HREF="x562.html"></HEAD
+><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>Mr. Voice 2.2 Installation and Reference Manual</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="c293.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="x562.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="CHAPTER"
+><H1
+><A
+NAME="AEN389"
+></A
+>Chapter 3. Using Mr. Voice</H1
+><P
+>Now that you have Mr. Voice and other required software set up and configured, it's time to actually use it. First you have to populate the database with songs. Then you can do useful things with them. Look at the following screenshot of the main Mr. Voice window to familiarize yourself with the layout.
+ <DIV
+CLASS="FIGURE"
+><A
+NAME="AEN392"
+></A
+><P
+><B
+>Figure 3-1. The Main window</B
+></P
+><DIV
+CLASS="MEDIAOBJECT"
+><P
+><IMG
+SRC="../images/mainwindow.png"></P
+></DIV
+></DIV
+>
+ </P
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="AEN399"
+>3.1. Adding, Deleting, and Editing Songs and Categories</A
+></H1
+><P
+>Mr. Voice lets you set up categories, then put your songs into those categories for later use. So we'll address the categories first.</P
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN402"
+>3.1.1. Categories</A
+></H2
+><P
+>Category options are very simple. You can either add a category, edit its long (descriptive) name, or delete a category. All options can be found under the <SPAN
+CLASS="GUIMENU"
+>Categories</SPAN
+> menu on the main display.</P
+><P
+>To add a new category, choose <SPAN
+CLASS="GUIMENU"
+>Categories</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Add Category</SPAN
+>. You will then have a box pop up where you can enter two items: The <SPAN
+CLASS="GUILABEL"
+>Category Code</SPAN
+> and the <SPAN
+CLASS="GUILABEL"
+>Category Description</SPAN
+>.
+ <DIV
+CLASS="FIGURE"
+><A
+NAME="AEN413"
+></A
+><P
+><B
+>Figure 3-2. The Add Category window</B
+></P
+><DIV
+CLASS="MEDIAOBJECT"
+><P
+><IMG
+SRC="../images/addcat.png"></P
+></DIV
+></DIV
+>
+ The Category Code is a short (4-5 letters max.) identifier for the category, whereas the Category Description is the longer name that you'll normally see. However, make the Category Code something useful, because it will be displayed next to the Choose Category button on the main window. For example, if you want a category called "Joe's Fly Tunes", you could use "JOE" for the Category Code and "Joe's Fly Tunes" for the category description. </P
+><P
+>To delete a category, choose <SPAN
+CLASS="GUIMENU"
+>Categories</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Delete Category</SPAN
+>. A box will pop up listing all of your defined categories. You can choose the button next to the category that you would like to delete, then press <SPAN
+CLASS="GUIBUTTON"
+>Ok</SPAN
+> to delete the category.
+ <DIV
+CLASS="FIGURE"
+><A
+NAME="AEN425"
+></A
+><P
+><B
+>Figure 3-3. The Delete Category window</B
+></P
+><DIV
+CLASS="MEDIAOBJECT"
+><P
+><IMG
+SRC="../images/delcat.png"></P
+></DIV
+></DIV
+></P
+><DIV
+CLASS="IMPORTANT"
+><P
+></P
+><TABLE
+CLASS="IMPORTANT"
+WIDTH="100%"
+BORDER="0"
+><TR
+><TD
+WIDTH="25"
+ALIGN="CENTER"
+VALIGN="TOP"
+><IMG
+SRC="../images/important.gif"
+HSPACE="5"
+ALT="Important"></TD
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
+><P
+>You cannot delete a category if it still has songs in it. Delete/edit all songs out of the category before trying to delete it.</P
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>Finally, you can edit a category, by choosing the <SPAN
+CLASS="GUIMENU"
+>Categories</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Edit Category</SPAN
+> menu. Once there, you can edit the long name, but not the short code, of the category.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN438"
+>3.1.2. Songs</A
+></H2
+><P
+>Songs are the audio data that you're trying to play. You can use any sort of audio data that your audio player can handle, but Mr. Voice can figure out things like playing time for MP3, WAV, Ogg Vorbis, AAC, and WMA files. If you're not trying to store, categorize, and play audio data, then you're probably using the wrong program! This manual will refer to the audio data that you are storing as "songs", even though they can, of course, be any kind of audio. To manipulate songs in the database, there are three main actions: adding songs, deleting songs, and editing songs.</P
+><P
+>To insert a new song into the database, choose <SPAN
+CLASS="GUIMENU"
+>Songs</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Add New Song</SPAN
+>. A box will pop up for the needed information:
+ <DIV
+CLASS="FIGURE"
+><A
+NAME="AEN445"
+></A
+><P
+><B
+>Figure 3-4. The Add Song window</B
+></P
+><DIV
+CLASS="MEDIAOBJECT"
+><P
+><IMG
+SRC="../images/addsong.png"></P
+></DIV
+></DIV
+></P
+><P
+></P
+><UL
+><LI
+><P
+><SPAN
+CLASS="GUILABEL"
+>Song Title</SPAN
+>: This is where you put the title of the song that you are adding.</P
+></LI
+><LI
+><P
+><SPAN
+CLASS="GUILABEL"
+>Artist</SPAN
+>: The artist responsible for the song. This is an <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>optional</I
+></SPAN
+> item.</P
+></LI
+><LI
+><P
+><SPAN
+CLASS="GUILABEL"
+>Category</SPAN
+>: Pressing the <SPAN
+CLASS="GUILABEL"
+>Choose Category</SPAN
+> button beside this entry will give you a list of the categories that you currently have defined. You must choose one of these categories to place the song into.</P
+></LI
+><LI
+><P
+><SPAN
+CLASS="GUILABEL"
+>Category Extra Info</SPAN
+>: Kind of a "hodgepodge" entry, this information can be whatever you want. At ComedyWorx, we use it as a modifier for the category. So if the category is "Game", the Extra Info is the name of the game. If the category is for Player Intros, the Extra Info will tell us whether it's specifically for a referee, dimwit, or whatnot. So, basically it's just free-form for whatever you need, and is an <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>optional</I
+></SPAN
+> field.</P
+></LI
+><LI
+><P
+><SPAN
+CLASS="GUILABEL"
+>Publisher</SPAN
+>: This field is for the publisher of the song. Current values are ASCAP, BMI, or Other. The default value is Other, which should be fine for people who don't want to bother with publisher information. But if you're using Mr. Voice in an organization that needs this information, here's where you can put it.</P
+></LI
+><LI
+><P
+><SPAN
+CLASS="GUILABEL"
+>File To Add</SPAN
+>: This is where you give Mr. Voice the path to the actual audio file that you want to add. Clicking the <SPAN
+CLASS="GUIBUTTON"
+>Select File</SPAN
+> button will bring up a familiar "file chooser" box. The screenshot below is from a Linux system - Windows users will see the familiar Windows file chooser box.
+ <DIV
+CLASS="FIGURE"
+><A
+NAME="AEN475"
+></A
+><P
+><B
+>Figure 3-5. The Add Song File Selection window</B
+></P
+><DIV
+CLASS="MEDIAOBJECT"
+><P
+><IMG
+SRC="../images/addsong-files.png"></P
+></DIV
+></DIV
+>
+ Use this to go to the location of your file, left-click on the name of the file, then click <SPAN
+CLASS="GUIBUTTON"
+>Open</SPAN
+>. The name of the file should now be listed in the <SPAN
+CLASS="GUILABEL"
+>File To Add</SPAN
+> box. If the file you are adding is an MP3, OGG, AAC, or WMA with valid tag information, it will automatically fill in the Title and Artist fields with that information.</P
+></LI
+><LI
+><P
+><SPAN
+CLASS="GUIBUTTON"
+>Preview Song</SPAN
+>: Once you have selected a file, you can press this button to hear the song. Useful for making sure you have the song you want before you add it.</P
+></LI
+></UL
+><P
+>You can now press the <SPAN
+CLASS="GUIBUTTON"
+>Ok</SPAN
+> button to add the song. If all goes well, you should see a message that the file was added to the database. If not, Mr. Voice should tell you what went wrong, and let you go back and fix the entry.</P
+><DIV
+CLASS="NOTE"
+><P
+></P
+><TABLE
+CLASS="NOTE"
+WIDTH="100%"
+BORDER="0"
+><TR
+><TD
+WIDTH="25"
+ALIGN="CENTER"
+VALIGN="TOP"
+><IMG
+SRC="../images/note.gif"
+HSPACE="5"
+ALT="Note"></TD
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
+><P
+>Mr. Voice actually makes a copy of the file that you select, renames it to a standard form, and places the new copy in the location given by the <CODE
+CLASS="VARNAME"
+>$filepath</CODE
+> variable that you defined in the setup. Your original audio file is <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>not</I
+></SPAN
+> used after the copy is made, so you can feel free to delete it.</P
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>It can be tedious to add songs one at a time if you have many files to add. New in version 1.8 is the <SPAN
+CLASS="GUIMENU"
+>Songs</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Bulk-Add Songs Into Category</SPAN
+> menu option. Upon choosing this, you will be prompted for a category and a directory. Select the category, and a directory that contains the set of MP3, OGG, AAC, or WMA files that you would like to add to that category. Mr. Voice will then use the title and artist tags stored in the files to automatically add those files into your selected category. If you need to add Extra Info or modify any other fields, you will need to do that after the fact, but this should be a good way to add lots of data at once. You can also specify a publisher here, useful when adding a whole CD's worth of songs with the same publisher.</P
+><P
+>There are two other ways to add songs. The first is that you can select song files on your desktop or file explorer, and drop them onto the main search box of Mr. Voice. When you do that, the Add New Song function will be launched on those files. Finally, you can choose the <SPAN
+CLASS="GUIMENU"
+>Songs</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Add Songs From Bundle</SPAN
+> menu item. That will allow you to import a Mr. Voice "bundle" ZIP file. All songs in the bundle will be added, along with all information about the file, and any needed categories will be automatically created.</P
+><P
+>To delete a song, you must have at least one displayed and selected in the main search results box. Searching is covered later, but if you hit the <SPAN
+CLASS="GUIBUTTON"
+>Do Search</SPAN
+> button, it should show you all of the songs in your database.</P
+><P
+>Once you have some songs displayed, left-click once on the name of the song that you want to delete, or select several songs by pressing <B
+CLASS="KEYCAP"
+>Control</B
+> or <B
+CLASS="KEYCAP"
+>Shift</B
+> while selecting, then choose <SPAN
+CLASS="GUIMENU"
+>Songs</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Delete Currently Selected Song</SPAN
+>. You can also right-click on the name of the song or songs and choose the <SPAN
+CLASS="GUIMENUITEM"
+>Delete Song</SPAN
+> option. A box will pop up asking you to confirm the deletion, and also presenting a checkbox labeled <SPAN
+CLASS="GUILABEL"
+>Delete File On Disk</SPAN
+>.
+ <DIV
+CLASS="FIGURE"
+><A
+NAME="AEN511"
+></A
+><P
+><B
+>Figure 3-6. The Delete Song window</B
+></P
+><DIV
+CLASS="MEDIAOBJECT"
+><P
+><IMG
+SRC="../images/delsong.png"></P
+></DIV
+></DIV
+>
+ If you do not select this, the song or songs will be removed from the database, but the actual audio file on disk, located at <CODE
+CLASS="VARNAME"
+>$filepath</CODE
+>, will remain. If you do select this option, the song or songs will be removed from the database AND the audio file on disk will be deleted.</P
+><DIV
+CLASS="NOTE"
+><P
+></P
+><TABLE
+CLASS="NOTE"
+WIDTH="100%"
+BORDER="0"
+><TR
+><TD
+WIDTH="25"
+ALIGN="CENTER"
+VALIGN="TOP"
+><IMG
+SRC="../images/note.gif"
+HSPACE="5"
+ALT="Note"></TD
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
+><P
+>If you do not have a song selected in the main display box and choose <SPAN
+CLASS="GUIMENU"
+>Songs</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Delete Currently Selected Song</SPAN
+> or <SPAN
+CLASS="GUIMENU"
+>Songs</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Edit Currently Selected Song</SPAN
+>, then nothing will happen. This is normal. If you are trying to edit or delete a song and don't get the repective boxes showing up on-screen, make sure that you have a song highlighted.</P
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>Finally, if you want to edit a song in the database, left-click a song in the main display window, and choose <SPAN
+CLASS="GUIMENU"
+>Songs</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Edit Currently Selected Song</SPAN
+>. You can also right-click on a song and choose the <SPAN
+CLASS="GUIMENUITEM"
+>Edit Song</SPAN
+> option. A box will pop up that is similar to the one for <SPAN
+CLASS="GUIMENU"
+>Songs</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Add New Song</SPAN
+>, except without the file selector option. You can make any needed changes to the song, then press <SPAN
+CLASS="GUIBUTTON"
+>Ok</SPAN
+> to commit them.</P
+><DIV
+CLASS="NOTE"
+><P
+></P
+><TABLE
+CLASS="NOTE"
+WIDTH="100%"
+BORDER="0"
+><TR
+><TD
+WIDTH="25"
+ALIGN="CENTER"
+VALIGN="TOP"
+><IMG
+SRC="../images/note.gif"
+HSPACE="5"
+ALT="Note"></TD
+><TH
+ALIGN="LEFT"
+VALIGN="MIDDLE"
+><B
+>Shortcut!</B
+></TH
+></TR
+><TR
+><TD
+>&nbsp;</TD
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
+><P
+>You can also right-click a song in the main display box to bring up a shortcut menu. From this menu, you can choose to edit or delete the selected song.</P
+></TD
+></TR
+></TABLE
+></DIV
+><P
+>If you have multiple songs selected and choose to edit, you will only be able to edit the Extra Info, Category, or Artist fields, not the Title.</P
+><P
+>There is a menu choice named <SPAN
+CLASS="GUIMENU"
+>Songs</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Update Song Times/MD5s</SPAN
+>. This will re-index all your song files, updating their play times and the MD5 sum (used in Mr. Voice online to see if two songs are the same). While in theory this information should be set when the song is added and never change, you may want to run it every once in a while to make sure the information is correct. If you edit a file in your MP3 directory manually, or replace a file in the MP3 directory directly with a new one, you will need to run this procedure. This process could take a while, depending on the speed of your computer, so you may not want to run it in the middle of a show.</P
+><DIV
+CLASS="SECT3"
+><H3
+CLASS="SECT3"
+><A
+NAME="AEN544"
+>3.1.2.1. Orphaned Files</A
+></H3
+><P
+>Orphaned files are audio files in your MP3 directory that are not referenced by any entries in the Mr. Voice database. They normally result from deleting a song from the database without deleting the file on disk. Since nothing in the database knows about them, they are unneeded and just take up space.</P
+><P
+>In previous versions of Mr. Voice, a separate program named <TT
+CLASS="FILENAME"
+>orphans.pl</TT
+> was provided to weed out these old files. However, with Mr. Voice 1.10, the orphan checker is integrated into the main program. You can find it under <SPAN
+CLASS="GUIMENU"
+>Advanced Search</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Find orphaned files</SPAN
+>. When you choose that menu item, Mr. Voice will scan your MP3 directory and compare it with your database, and if it finds any orphaned files, display them for you.
+ <DIV
+CLASS="FIGURE"
+><A
+NAME="AEN552"
+></A
+><P
+><B
+>Figure 3-7. Orphaned Files Report</B
+></P
+><DIV
+CLASS="MEDIAOBJECT"
+><P
+><IMG
+SRC="../images/orphans.png"></P
+></DIV
+></DIV
+>
+ </P
+><P
+>When the Orphaned File report is displayed, you have a couple of choices. If you just want to read the report without taking action, you can close the window and no changes will be made. You can also select one or more files from the report to delete. To do so, Control-click on a filename to add it to the selection group. Or, hit the <SPAN
+CLASS="GUIBUTTON"
+>Select All</SPAN
+> button to select all entries, and Control-click to deselect any you do not want to delete. Then press the <SPAN
+CLASS="GUIBUTTON"
+>Delete Selected</SPAN
+> button to remove all selected files from your computer.</P
+></DIV
+></DIV
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="c293.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="index.html"
+ACCESSKEY="H"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="x562.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Configuring Mr. Voice</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Searching and Playing Songs</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
View
155 doc/html/c744.html
@@ -0,0 +1,155 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML
+><HEAD
+><TITLE
+>Mr. Voice Online</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
+REL="HOME"
+TITLE="Mr. Voice 2.2 Installation and Reference Manual"
+HREF="index.html"><LINK
+REL="PREVIOUS"
+TITLE="Hotkeys"
+HREF="x629.html"><LINK
+REL="NEXT"
+TITLE="Using Mr. Voice Online"
+HREF="x752.html"></HEAD
+><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>Mr. Voice 2.2 Installation and Reference Manual</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="x629.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="x752.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="CHAPTER"
+><H1
+><A
+NAME="AEN744"
+></A
+>Chapter 4. Mr. Voice Online</H1
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="AEN746"
+>4.1. What Is Mr. Voice Online?</A
+></H1
+><P
+>Mr. Voice Online is an attempt to improve the selection of audio available for improv shows, as well as to build a community among people running sound for improv clubs. The first attempt at Mr. Voice Online was a small subsection of the Mr. Voice website, where people could upload or download files. It suffered from lack of use. My theory was that it may be cumbersome to lug files around, have to re-enter the song information, and upload songs through a website.</P
+><P
+>Starting with Mr. Voice 2.1, I've integrated the online functionality into the Mr. Voice application itself. If you have an internet connection on your Mr. Voice system, you can now upload, download, and search songs in the online database directly from Mr. Voice itself. We shall see if this proves easier to use.</P
+><P
+>To get started with Mr. Voice online, you will need a key. I am not intending this project to turn into a large-scale filesharing community, so I am restricting use to people involved in improv clubs or other legitimate environments. Getting a key, if you meet those conditions, is simple. Fill out the New Key request form at <A
+HREF="http://www.mrvoice.net/online/getkey/"
+TARGET="_top"
+>the Mr. Voice website</A
+> (or send an email to minter@mrvoice.net) with your name, the name of your group, and your website. I'll send you back a key string that looks something like "ac78fe9d-9210-46db-bd40-1b0e27997ead". Put that string in the Online Options section of your Preferences, check the "Enable online functionality" button, and you're set. New in 2.2, there is an extra option in that Preference window that lets you change the Mr. Voice Online URL, in case I change it again on my end (like happened between 2.1 and 2.2).</P
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="x629.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="index.html"
+ACCESSKEY="H"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="x752.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Hotkeys</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Using Mr. Voice Online</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
View
284 doc/html/c793.html
@@ -0,0 +1,284 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML
+><HEAD
+><TITLE
+>Troubleshooting and FAQs</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
+REL="HOME"
+TITLE="Mr. Voice 2.2 Installation and Reference Manual"
+HREF="index.html"><LINK
+REL="PREVIOUS"
+TITLE="Using The Mr. Voice Online Website"
+HREF="x784.html"><LINK
+REL="NEXT"
+TITLE="Known Bugs and Issues"
+HREF="a850.html"></HEAD
+><BODY
+CLASS="CHAPTER"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>Mr. Voice 2.2 Installation and Reference Manual</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="x784.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+></TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="a850.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="CHAPTER"
+><H1
+><A
+NAME="AEN793"
+></A
+>Chapter 5. Troubleshooting and FAQs</H1
+><P
+>This section will eventually contain answers to frequently asked questions, troubleshooting ideas, and helpful tips.</P
+><P
+></P
+><UL
+><LI
+><P
+><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>I double-click the Mr. Voice icon under Windows, and the program doesn't come up. What's wrong?</I
+></SPAN
+></P
+><P
+>To diagnose a problem like this, Mr. Voice sends debugging output to a file. That file is <TT
+CLASS="FILENAME"
+>C:/mrvoice.log</TT
+> under Windows or <TT
+CLASS="FILENAME"
+>~/mrvoice.log</TT
+> under Unix. You can use that file to figure out what's going wrong, or send it to me so I can debug the problem.</P
+></LI
+><LI
+><P
+><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>When I try to fade-stop a song, I get a "pop" of volume at the end. How do I fix that?</I
+></SPAN
+></P
+><P
+>Randy in KC has written up steps that he used to solve this problem. He recommends doing the following. Right mouse click on Winamp. Choose Options-&#62;Preferences-&#62;Plug Ins-&#62;Output. Highlight DirectSound Output v 2.2.10. Click Configure. Choose Fading Tab. Select "Old Style Fade on pause". Hit Apply.</P
+></LI
+><LI
+><P
+><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Now that I've got all this stuff in my database, how do I back it up?</I
+></SPAN
+></P
+><P
+>There are two things that need to be taken into account when you do backups: The MP3 files themselves, and the information in the database.</P
+><P
+><SPAN
+CLASS="strong"
+><B
+CLASS="EMPHASIS"
+>BACKING UP THE MP3 FILES</B
+></SPAN
+></P
+><P
+>This is both the easiest and hardest part of the equation. It's the easiest because backing up the MP3 files involves only copying them to another place, so that you are covered in case something happens to the files themselves (disk crash, accidental deletion, etc.)</P
+><P
+>It's the hardest, though, because you're generally talking about a gigabyte-plus of data, which limits your transfer options. Some suggestions for MP3 file backups include:
+ <P
+></P
+><UL
+><LI
+><P
+>A second hard drive in your computer. Will protect against a drive crash, OS crash, or accidental deletion, but will not protect against on-site disasters (physical damage to the computer, fire, locusts, etc.)</P
+></LI
+><LI
+><P
+>Burning files to CD/DVD. Easy off-site storage, but requires the purchase of a burner if you don't already have one.</P
+></LI
+><LI
+><P
+>Copying files to another computer over a network. This is what I do - I have a network card (~$15) in the voice computer, and use an ethernet cable to copy the files over to my laptop. Transfer time is fast. You can also use things like a USB link cable to transfer files between computers.</P
+></LI
+><LI
+><P
+>Copying the files onto several thousand floppy disks. Time-consuming and not recommended. ;-)</P
+></LI
+></UL
+>
+ </P
+><P
+><SPAN
+CLASS="strong"
+><B
+CLASS="EMPHASIS"
+>BACKING UP THE DATABASE</B
+></SPAN
+></P
+><P
+>Backing up the files themselves is good, but there's another step involved. You need to back up the information in your database, so that all of your meta-data (categories, extra info, etc.) isn't lost. The database actually drives the Mr. Voice program, too, so if you lose the database data, Mr. Voice will be pretty useless.</P
+><P
+>Beginning with Mr. Voice version 1.7, you can use the <SPAN
+CLASS="GUIMENU"
+>File</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Backup Database To A File</SPAN
+> menu choice to export the contents of your database to a file. You can then copy that file to a safe place. Also, beginning with version 2.0, you can back up the SQLite .db file itself to a safe place. Just copy the .db file to another computer, and you've got the same database that the original one had! Check the <SPAN
+CLASS="GUIMENU"
+>File</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Preferences</SPAN
+> menu for the location of the file.</P
+><P
+><SPAN
+CLASS="strong"
+><B
+CLASS="EMPHASIS"
+>OTHER THINGS TO BACKUP</B
+></SPAN
+></P
+><P
+>You may also want to back up your saved hotkey files from the directory listed in the <SPAN
+CLASS="GUIMENU"
+>File</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Preferences</SPAN
+> menu, as well as <TT
+CLASS="FILENAME"
+>C:\mrvoice.cfg</TT
+> on Windows or <TT
+CLASS="FILENAME"
+>~/.mrvoicerc</TT
+> on Unix. Backing up all of this data should allow you to completely restore your system in the event that something goes wrong.</P
+><P
+>As of Mr. Voice 2.2, there is also a new menu option at <SPAN
+CLASS="GUIMENU"
+>File</SPAN
+>-&gt;<SPAN
+CLASS="GUIMENUITEM"
+>Export Song List</SPAN
+> that will export the full list of songs in your database to either an ASCII text file or a Microsoft Excel spreadsheet, for offline reading or backup purposes.</P
+><P
+><SPAN
+CLASS="strong"
+><B
+CLASS="EMPHASIS"
+>WHEN TO BACKUP?</B
+></SPAN
+></P
+><P
+>In the event of a system failure, you will lose all of the changes to your system between the last time you backed up, and the time of the failure. So keep that in mind when you decide how often to back up. For some, backups every month or two might work, for others, weekly or more frequent.</P
+></LI
+></UL
+><P
+>If you have questions or tips that you think should be addressed here, email them to me.</P
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="x784.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="index.html"
+ACCESSKEY="H"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="a850.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Using The Mr. Voice Online Website</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+>&nbsp;</TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Known Bugs and Issues</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
View
146 doc/html/f45.html
@@ -0,0 +1,146 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML
+><HEAD
+><TITLE
+>Foreword</TITLE
+><META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
+REL="HOME"
+TITLE="Mr. Voice 2.2 Installation and Reference Manual"
+HREF="index.html"><LINK
+REL="PREVIOUS"
+TITLE="Mr. Voice 2.2 Installation and Reference Manual"
+HREF="index.html"><LINK
+REL="NEXT"
+TITLE="What's New"
+HREF="f52.html"></HEAD
+><BODY
+CLASS="PREFACE"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>Mr. Voice 2.2 Installation and Reference Manual</TH