Initial revision
This commit is contained in:
Jeremy Newman
2
help/.cvsignore
Normal file
2
help/.cvsignore
Normal file
@@ -0,0 +1,2 @@
|
||||
stderr
|
||||
|
||||
66
help/appdb_faq.help
Normal file
66
help/appdb_faq.help
Normal file
@@ -0,0 +1,66 @@
|
||||
<!--TITLE: Application Database FAQ -->
|
||||
|
||||
<h3>Application Database FAQ</h3>
|
||||
|
||||
<p>This FAQ answers questions related to the usage of the
|
||||
Application Database.</p>
|
||||
|
||||
<ul>
|
||||
|
||||
<p><b>Q: What is the Application Database?</b></p>
|
||||
<blockquote>
|
||||
<p><b>A:</b> The Application Database is a repository for
|
||||
compatibility information of applications for Microsoft Windows
|
||||
running on Wine.<p>
|
||||
</blockquote>
|
||||
|
||||
<p><b>Q: What is Wine?</b></p>
|
||||
<blockquote>
|
||||
<p><b>A:</b> Wine is an execution layer that allows Windows programs to be run
|
||||
on Linux Systems. More information can be found at the
|
||||
<a href="http://www.winehq.com/fom-meta/cache/3.html">Wine FAQ</a>.<p>
|
||||
</blockquote>
|
||||
|
||||
<p><b>Q: What is the benefit Application Database?</b></p>
|
||||
<blockquote>
|
||||
<p><b>A:</b> The Application database will give the Wine developers a
|
||||
resource for compatibility information. This will allow them to focus their
|
||||
efforts on those applications the community most wants to see working. It also
|
||||
provides end-user support. Users can find out before they even install Wine if
|
||||
their application is supported.<p>
|
||||
</blockquote>
|
||||
|
||||
<p><b>Q: How does a new application get added to the database?</b></p>
|
||||
<blockquote>
|
||||
<p><b>A:</b> In order to ensure consistency, only authorized application database
|
||||
maintainers are permitted to add new applications to the database.
|
||||
Anyone can comment on, or rate a particular application.</p>
|
||||
<p>Anyone can request that an application be added to the database,
|
||||
but the application is not actually added until after it has been
|
||||
reviewed and categorized by a maintainer.</p>
|
||||
</blockquote>
|
||||
|
||||
<p><b>Q: How can I submit HowTo's and Screenshots?</b></p>
|
||||
<blockquote>
|
||||
<p><b>A:</b> We love to hear from our users. Send those helpful HowTo's and
|
||||
Screenshots right on over to <a href="mailto:appdb@winehq.com">appdb@winehq.com</a>.
|
||||
We'll be happy to post them, and give you proper credit for your great contribution.</p>
|
||||
</blockquote>
|
||||
|
||||
|
||||
<p><b>Q: How do I become an authorized application database maintainer.</b></p>
|
||||
<blockquote>
|
||||
<p><b>A:</b> Pretty much anyone with an established reputation supporting Wine
|
||||
is welcome (begged?) to be an application maintainer.
|
||||
Simply send email to <a href="mailto:appdb@winehq.com">appdb@winehq.com</a>
|
||||
to apply. Once we have a community of maintainers, we hope that community
|
||||
will further refine the policies and procedures.</p>
|
||||
</blockquote>
|
||||
|
||||
</ul>
|
||||
|
||||
If you have more questions you would like to add to our FAQ, please contact us
|
||||
at <a href="mailto:appdb@winehq.com">appdb@winehq.com</a>.
|
||||
|
||||
<p> </p>
|
||||
|
||||
54
help/generic.help
Normal file
54
help/generic.help
Normal file
@@ -0,0 +1,54 @@
|
||||
<!--TITLE: Additional Wine Help -->
|
||||
|
||||
This is meant as generic instructions in case an AppDB entry
|
||||
for a certain program doesn't exist.
|
||||
|
||||
<ol>
|
||||
|
||||
<li> Make sure your Wine release is pretty recent.
|
||||
Current possibilities are:</li><p>
|
||||
|
||||
<ul>
|
||||
<li> <a href="http://www.codeweavers.com">CodeWeavers Wine</a> Preview
|
||||
simple, complete configuration</li>
|
||||
<li><a href="http://sourceforge.net/projects/winex">TransGaming WineX</a>,
|
||||
Wine version with special DirectX support, use this one for games.</li>
|
||||
<li> Misc. Wine packages/versions downloadable via
|
||||
<a href="http://www.winehq.com">WineHQ</a></li>
|
||||
</ul>
|
||||
<p>
|
||||
|
||||
<li> Run <a href="http://home.nexgo.de/andi.mohr/download/winecheck">winecheck</a>
|
||||
(chmod +x winecheck; ./winecheck)
|
||||
to verify the most important aspects of Wine environment
|
||||
configuration</li><p>
|
||||
|
||||
<li> Run your program</li><p>
|
||||
|
||||
<li> In case of failure, try different builtin, native DLL settings:
|
||||
Run Wine with --debugmsg +loaddll to find out which
|
||||
DLLs are loaded as native or builtin ones.
|
||||
Then make sure appropriate native versions are in the
|
||||
c:\windows\system directory as configured in your wine
|
||||
config file, and then use either --dll DLL1, DLL2,...=n or
|
||||
--dll DLL1,DLL2,...=b
|
||||
to use native or builtin setting for certain DLLs, respectively.</li><p>
|
||||
|
||||
<li> In case of persisting failure, check out
|
||||
<a href="http://www.winehq.com/Trouble/">Wine Troubleshooting Guide</a>
|
||||
and read all of the available documentation at
|
||||
<a href="http://www.winehq.com/support.shtml">WineHQ Support</a></li><p>
|
||||
|
||||
<li> If that doesn't help, then ask people on
|
||||
<a href="http://irc.openprojects.net">irc.openprojects.net</a>
|
||||
channel #WineHQ or on the
|
||||
<a href="http://www.winehq.com/mailman/listinfo/wine-users">wine-users</a>
|
||||
mailing list. </li><p>
|
||||
|
||||
<li> If you have more questions, please contact us
|
||||
at <a href="mailto:appdb@codeweavers.com">appdb@codeweavers.com</a>.</li><p>
|
||||
|
||||
</ol>
|
||||
|
||||
<p> </p>
|
||||
|
||||
102
help/index.php
Normal file
102
help/index.php
Normal file
@@ -0,0 +1,102 @@
|
||||
<?
|
||||
|
||||
/*
|
||||
* Application Database Documentation Center
|
||||
*
|
||||
*/
|
||||
|
||||
include("path.php");
|
||||
include(BASE."include/"."incl.php");
|
||||
|
||||
$help_path = $apidb_root."/help";
|
||||
|
||||
if($topic)
|
||||
{
|
||||
display_help($topic);
|
||||
} else {
|
||||
display_index();
|
||||
}
|
||||
|
||||
function display_index ()
|
||||
{
|
||||
global $help_path;
|
||||
global $apidb_root;
|
||||
|
||||
apidb_header("Documentation Index");
|
||||
|
||||
echo "<p><b>Providing all the help you need 24x7</b><p><hr noshade>\n";
|
||||
|
||||
echo "<ul>\n";
|
||||
|
||||
// read dir
|
||||
$files = array();
|
||||
$d = opendir($help_path);
|
||||
while($entry = readdir($d))
|
||||
{
|
||||
array_push($files, $entry);
|
||||
}
|
||||
closedir($d);
|
||||
|
||||
//sort dir
|
||||
sort($files);
|
||||
|
||||
// display dir
|
||||
while (list($key,$file) = each($files))
|
||||
{
|
||||
if(!ereg("(.+)\\.help$", $file, $arr))
|
||||
continue;
|
||||
|
||||
$id = $arr[1];
|
||||
$title = get_help_title("$help_path/$file");
|
||||
|
||||
echo " <li> <a href='".$apidb_root."help?topic=$id'> $title </a> </li><p>\n";
|
||||
}
|
||||
|
||||
echo "</ul><hr noshade>\n";
|
||||
|
||||
echo "<p>Need more help? Contact us at <a href='mailto:appdb@winehq.com'>appdb@winehq.com</a><p>\n";
|
||||
|
||||
apidb_footer();
|
||||
}
|
||||
|
||||
function display_help ($topic)
|
||||
{
|
||||
global $help_path;
|
||||
|
||||
$file = "$help_path/$topic.help";
|
||||
$title = get_help_title($file);
|
||||
|
||||
if(! $title) {
|
||||
$title = "Help on $topic";
|
||||
}
|
||||
|
||||
apidb_header($title);
|
||||
if(file_exists($file)) {
|
||||
include($file);
|
||||
} else {
|
||||
echo "<p><b> No help available on that topic </b><p>\n";
|
||||
}
|
||||
|
||||
apidb_footer();
|
||||
}
|
||||
|
||||
function get_help_title ($file)
|
||||
{
|
||||
$fp = @fopen($file, "r");
|
||||
if(!$fp)
|
||||
return null;
|
||||
|
||||
$line = fgets($fp, 1024);
|
||||
if(!$line)
|
||||
return null;
|
||||
|
||||
$line = trim($line);
|
||||
|
||||
if(eregi("^<!--TITLE: (.+)-->$", $line, $arr))
|
||||
{
|
||||
return $arr[1];
|
||||
}
|
||||
return "Internal Error: missing title";
|
||||
}
|
||||
|
||||
?>
|
||||
3
help/path.php
Normal file
3
help/path.php
Normal file
@@ -0,0 +1,3 @@
|
||||
<?
|
||||
define("BASE","../");
|
||||
?>
|
||||
45
help/privacy.help
Normal file
45
help/privacy.help
Normal file
@@ -0,0 +1,45 @@
|
||||
<!--TITLE: Application DB Privacy Policy -->
|
||||
|
||||
<h3>Application DB Privacy Policy</h3>
|
||||
|
||||
<p>
|
||||
<b>CodeWeavers is decidated to the privacy of its customers.</b><br>
|
||||
<ul>
|
||||
Whatever specific information you give to us will be used only to enable user
|
||||
specific features of the Application Database. We will give your information
|
||||
to no third parties, nor will we send you email you did not request. We may
|
||||
use your information in the aggregate to better understand our market.
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<p>
|
||||
<b>Cookies</b>
|
||||
<ul>
|
||||
The Application Database uses cookies only to preserve login information in your web browser.
|
||||
Advertisers or other companies do not have access to the AppDB's cookies.
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<p>
|
||||
<b>Changes to this Privacy Policy</b><br>
|
||||
<ul>
|
||||
We may amend this policy from time to time. If we make any
|
||||
substantial changes in the way we use your personal information we
|
||||
will notify you by posting a prominent announcement on our pages.
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<p>
|
||||
<b>Questions or Suggestions</b><br>
|
||||
<ul>
|
||||
If you have questions or suggestions, feel free to contact us at
|
||||
<a href="mailto:appdb@winehq.com">appdb@winehq.com</a>
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<p>
|
||||
<b>NOTICE:</b> <a href="http://www.ftc.gov/bcp/conline/pubs/online/sitesee/index.html">Click here</a>
|
||||
for important information about safe surfing from the Federal Trade Commission.
|
||||
</p>
|
||||
|
||||
<p> </p>
|
||||
95
help/ratings.help
Normal file
95
help/ratings.help
Normal file
@@ -0,0 +1,95 @@
|
||||
<!--TITLE: Ratings Help -->
|
||||
|
||||
<h3>Application Ratings System Help</h3>
|
||||
|
||||
<p>
|
||||
The Application Database features a rating system that allows us and you to see
|
||||
which applications work the best in Wine. This voting system is designed to be
|
||||
pessimistic.
|
||||
</p>
|
||||
|
||||
<ol>
|
||||
|
||||
<li>Log into the Application Database.</li><p>
|
||||
|
||||
<li>Browse to the Application you wish to rate.</li><p>
|
||||
|
||||
<li>In the sidebar, choose whether you are rating Wine running
|
||||
in Windows mode, or Fake Windows Mode.<br>
|
||||
<ul>
|
||||
<li><img src='../images/w1.gif' alt='With Windows'> <b>With Windows</b> = Wine Configured to use a Windows partition.</li>
|
||||
<li><img src='../images/w0.gif' alt='Without Windows'> <b>Without Windows</b> = Wine using its own internal Windows (Fake Windows).</li>
|
||||
</ul>
|
||||
</li><p>
|
||||
|
||||
<li>In the sidebar, click the number of stars you want to
|
||||
rate this application.<br>
|
||||
<ul>
|
||||
<li> <b>0</b> -- Unrated.
|
||||
<li> <b>1</b> -- Totally nonfunctional. Crashes on load.
|
||||
<li> <b>2</b> -- Partial functionality. Good enough for a carefully scripted demo.
|
||||
<li> <b>3</b> -- Sufficient functionality for noncritical work. Occasional crashes okay,
|
||||
as are weird setup problems, required patches, or missing major functionality.
|
||||
Alpha quality.
|
||||
<li> <b>4</b> -- Substantially correct. Good enough for general use, with possible
|
||||
caveats.
|
||||
<li> <b>5</b> -- Perfect. No flaws under any mode
|
||||
</ul>
|
||||
</li><p>
|
||||
|
||||
<li>Click the Rate! button to store your vote for this
|
||||
application.
|
||||
</li><p>
|
||||
|
||||
</ol>
|
||||
|
||||
|
||||
<b> How to rate an application </b></br>
|
||||
|
||||
<i>Please</i> don't exaggerate how well things work.
|
||||
It only creates expectations which
|
||||
can't be met, and doesn't do anybody
|
||||
any good in the long run.
|
||||
Here is a simple flowchart for testing applications.
|
||||
|
||||
<ul>
|
||||
|
||||
<li> First, figure out the name of the app, the vendor, and the product
|
||||
version number.</li><p>
|
||||
|
||||
<li> Try to start the application under the emulator.
|
||||
If it completes loading,
|
||||
without crashing, and displaying more or less what it would under
|
||||
some version of Windows, then the app deserves a 2. Otherwise, it gets a
|
||||
1.</li><p>
|
||||
|
||||
<li> Try doing a few things with it. If you can
|
||||
find several useful operations
|
||||
which can be correctly performed with the app, such that you would be
|
||||
willing to stand in front of a large group of people, saying ``This app
|
||||
works nearly perfectly on Wine'' and doing those operations, give it a 3.
|
||||
</li><p>
|
||||
|
||||
<li> If you don't normally use the app, stop here. Higher ratings should
|
||||
only be given for app performance under actual use.</li><p>
|
||||
|
||||
<li> At some time when there is something which you need to do with the
|
||||
app, try doing it under Wine. If you can get the job done without putting
|
||||
your fist through the screen, then the application deserves a 4. Note that
|
||||
this is not, ``Someone <i>could</i> do useful work with this app'' but
|
||||
``I have used this app for useful work, not just fooling around.''</li><p>
|
||||
|
||||
<li> If you use an app under Wine for months, and its behavior is robust
|
||||
under a variety of uses, its performance is adequate, and
|
||||
these characteristics are stable as Wine changes from release to release,
|
||||
and it works for a lot of people with varying setups under various OSes,
|
||||
then it deserves a 5.</li><p>
|
||||
|
||||
<li> After a new version of Wine, test the application again. If the app
|
||||
improves or gets worse, come back and change your vote.</li><p>
|
||||
|
||||
</ul>
|
||||
|
||||
Remember: only <i>you</i> can prevent rating inflation.
|
||||
|
||||
<p> </p>
|
||||
40
help/voting.help
Normal file
40
help/voting.help
Normal file
@@ -0,0 +1,40 @@
|
||||
<!--TITLE: Voting Help -->
|
||||
|
||||
<h3>Application Voting System Help</h3>
|
||||
|
||||
<p>
|
||||
The Application Database features a voting system that allows you to pick which <b>3</b> applications
|
||||
you would MOST like to see running in Wine.
|
||||
</p>
|
||||
|
||||
<p><b>Step by Step on Voting</b></p>
|
||||
<ol>
|
||||
|
||||
<li>Log into the Application Database.</li><p>
|
||||
|
||||
<li>Browse to the Application you wish to add to your vote list.</li><p>
|
||||
|
||||
<li>In the sidebar, Click one of the 3 available slots, and click Vote.</li><p>
|
||||
|
||||
<li>Done!</li></p>
|
||||
|
||||
</ol>
|
||||
|
||||
|
||||
<p><b> Voting System Notes </b></p>
|
||||
|
||||
<ul>
|
||||
|
||||
<li><i>Please</i> seriously only vote for applications which will benefit the community. Don't
|
||||
vote for applications that are known to work well. We know Solitaire works. Voting for it
|
||||
would not make much sense.</li><p>
|
||||
|
||||
<li>When voting for an application, you are voting for <b>ALL</b> its various versions. There is
|
||||
a separate system in place for ranking versions.</Li><p>
|
||||
|
||||
<li>You can clear your vote at anytime. Simply browse to any App in the database, select the app
|
||||
in your vote list you want to clear, and click the Clear button.</li><p>
|
||||
|
||||
</ul>
|
||||
|
||||
<p> </p>
|
||||
Reference in New Issue
Block a user