Readme files, as discussed on the list.

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@9328 a592a061-630c-0410-9148-cb99ea01b6c8

ChangeLog

@@ -1,3 +1,12 @@
+2004-11-25  Angus Leeming  <leeming@lyx.org>
+
+	* README.Cygwin: new file, containing the current contents of
+	README.Win32.
+
+	* README.Win32: rewritten to explain why we don't currently
+	provide formal support for a native Win32 port (other than
+	one based on Cygwin) and how that may change in the future.
+
 2004-11-29  Jean-Marc Lasgouttes  <lasgouttes@lyx.org>
 
 	* configure.ac: do not include broken_headers.h; do not check for

README.Cygwin

@@ -0,0 +1,39 @@
+================================================================
+README for Cygwin by Ruurd Reitsma (R.A.Reitsma@wbmt.tudelft.nl)
+================================================================
+
+LyX has been ported to Win32 using the Cygwin environement. The port
+consists of a few small tweaks to deal with DOS-style pathnames, so
+LyX can use Win32 TeX distros like fptex and MiKTeX. There's also a
+cygwin TeTeX port, but the native Win32 ports have a definite speed
+advantage. Besides that, nothing fancy.
+
+The prerequisites are (obviously?):
+
+* cygwin installation (http://www.cygwin.com/).
+* decent X server; eXceed, X-Win32, or maybe even Cygwin/XFree86.
+* working TeX installation; fpTex, MikTex.
+
+It should compile out of the box, but there might be some libraries
+missing in the final link step. You'll have to add them to the Makefile
+by hand. Be sure to include -lregex, because cygwin's builtin regex is
+sortof weird (filedialogs will turn up empty...)
+
+If you want to run lyx with no console windows open, there's a small
+program in development/Win32 that will set the proper environment vars
+and start lyx.
+
+Compile with:
+
+gcc lyxwin32.C -O2 -o lyxwin32 -static -Wall -Wno-format \
+-Wstrict-prototypes -Wmissing-prototypes -mwindows -e _mainCRTStartup
+
+Also make sure the latex binaries are in your Windows path. Windvi and
+Yap are auto detected, and you might want to make a symlink to Adobe
+Acrobat so it's detected too:
+
+ln -s //c/Program\ Files/adobe/Acrobat\ 4.0/Reader/AcroRd32.exe \
+/usr/bin/acroread
+
+Many thanks to Steven van Dijk, Claus Hentschel and Miyata Shigeru for
+starting the porting business.

README.Win32

@@ -1,39 +1,31 @@
-================================================================
+================
-README for Win32 by Ruurd Reitsma (R.A.Reitsma@wbmt.tudelft.nl)
+README for Win32
-================================================================
+================
 
-Lyx has been ported to Win32 using the Cygwin environement. The port
+LyX has been ported to Win32 using the Cygwin environement.
-consists of a few small tweaks to deal with DOS-style pathnames, so
+See README.Cygwin for details.
-LyX can use Win32 TeX distros like fptex and MiKTeX. There's also a
-cygwin TeTeX port, but the native Win32 ports have a definite speed
-advantage. Besides that, nothing fancy.
 
-The prerequisites are (obviously?):
+In addition, Ruurd Reitsma has created a native port of LyX on Win32
+using the binary Qt/Win32 2.3.0 library. It is not clear whether we
+are legally allowed to distribute this library. Certainly, using it
+goes against the spirit of Open Source software and we have chosen,
+therefore, not to provide formal support for Ruurd's port.
 
-* cygwin installation (http://www.cygwin.com/).
+Having said that, you'll find the executable, together with lots of
-* decent X server; eXceed, X-Win32, or maybe even Cygwin/XFree86.
+useful tips, on Ruurd's site: http://www.home.zonnet.nl/rareitsma/lyx/
-* working TeX installation; fpTex, MikTex.
+The Win32 pages on the LyX wiki will also be useful:
+http://wiki.lyx.org/pmwiki.php/LyX/LyX
+Finally, you'll find lots of friendly help on the lyx users'
+mailing list: lyx-users@lists.lyx.org
 
-It should compile out of the box, but there might be some libraries
+Trolltech has stated that they do not intend to release
-missing in the final link step. You'll have to add them to the Makefile
+Qt/Win under the GPL. However, it is likely that a native port of LyX
-by hand. Be sure to include -lregex, because cygwin's builtin regex is
+to Windows will be supported formally in the future, for two reasons:
-sortof weird (filedialogs will turn up empty...)
 
-If you want to run lyx with no console windows open, there's a small
+* A frontend for LyX using the Gtk libraries is under active 
-program in development/Win32 that will set the proper environment vars
+development. The Gtk libraries for Win32 are indeed released under 
-and start lyx.
+the GPL.
 
-Compile with:
+* Some success has been reported compiling LyX on Win32 using the 
-
+GPL-ed port of qt/x11 to Win32 by the kde-cygwin project. See 
-gcc lyxwin32.C -O2 -o lyxwin32 -static -Wall -Wno-format \
+http://kde-cygwin.sourceforge.net/qt3-win32/index.php
--Wstrict-prototypes -Wmissing-prototypes -mwindows -e _mainCRTStartup
-
-Also make sure the latex binaries are in your Windows path. Windvi and
-Yap are auto detected, and you might want to make a symlink to Adobe
-Acrobat so it's detected too:
-
-ln -s //c/Program\ Files/adobe/Acrobat\ 4.0/Reader/AcroRd32.exe \
-/usr/bin/acroread
-
-Many thanks to Steven van Dijk, Claus Hentschel and Miyata Shigeru for
-starting the porting business.