--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/admin/wine-issues.txt	Sat Dec 22 17:52:45 2007 -0500
@@ -0,0 +1,51 @@
+Issues and problems specifically with using AG under Wine.
+
+------------------------------------------------------------
+(most serious)
+
+Something about the font handling, whether in AG or more likely in the
+IBM class library, does not get along with Wine.  Consequently,
+everything appears only in some crappy default font and nothing you do
+with the Set Fonts dialog has any effect.
+
+This makes marked tokens indistiguishable from unmarked tokens, which
+means you can't tell where you are in the Grammar Trace and File Trace
+and thus makes those windows nearly impossible to use. This in turn
+makes AG almost useless in Wine.
+
+Possible workaround: could reenable the old code for putting marked
+tokens in <>. But this should be either user-switchable or based on
+having detected wine. Blah.
+
+Another possible workaround: change the text color for marked tokens.
+
+------------------------------------------------------------
+When you click on an open AG window name from the Windows menu of
+the AG control panel, the window does not come to the foreground. If
+completely hidden, it will remain so.
+
+------------------------------------------------------------
+Various weird things happen with control of the window focus,
+window icons, window titles, raising and lowering windows, and other
+things that interact with the window manager in X.
+
+------------------------------------------------------------
+In Wine it doesn't seem to notice when the syntax file has been
+changed underneath it. I'm reasonably sure that in Windows it does and
+that this feature wasn't limited to the DOS version. (I think it
+normally checks when it receives the window focus, which is
+problematic as per the previous issue.)
+
+------------------------------------------------------------
+The icon for the Analyze Grammar button often fails to display or
+refresh if covered and uncovered. (The other buttons are sometimes
+affected too, but mostly only the Analyze Grammar button gets messed
+up without provocation.) I'm sure this is a Wine issue, but it would
+be nice if it didn't break.
+
+------------------------------------------------------------
+AG does not work at all in Wine on NetBSD. Neither do various other
+things; the problems is/are in Wine, not AG. See 
+http://www.netbsd.org/cgi-bin/query-pr-single.pl?number=32800
+for some further information.
+