File	Date	Author	Commit
dev	2020-10-19	Nam-Quang Tran	[a09b86] Bugfix: On Windows, the taskbar pinning of the ...
dist	2024-04-23	Nam-Quang Tran	[5a356c] File mode changes (removed executable flags).
lib	2024-04-23	Nam-Quang Tran	[5a356c] File mode changes (removed executable flags).
src	2024-04-23	Nam-Quang Tran	[5a356c] File mode changes (removed executable flags).
src-daemon	2018-05-05	huzhengmian	[1f88a0] transform to a intellij project.
.classpath	2019-02-12	Nam-Quang Tran	[f441ce] PDFBox upgrade: Forgot to update the .classpath...
.gitignore	2021-03-21	Nam-Quang Tran	[6892b7] Upgraded SWT on macOS from 4.9 to 4.19. Fixes N...
.project	2014-02-18	Tran Nam Quang	[4d0127] - Removed AspectJ dependency.
DocFetcher-1.1.iml	2024-01-24	Nam-Quang Tran	[95e7df] Updated IntelliJ IDEA project configuration.
ant-contrib-1.0b3.jar	2011-11-08	Tran Nam Quang	[a86c3c] Added daemons for portable version.
build-daemon.xml	2011-11-08	Tran Nam Quang	[a86c3c] Added daemons for portable version.
build-dmg.sh	2021-03-24	Nam-Quang Tran	[899866] Minor changes in the build-dmg.sh script.
build-man.py	2022-07-31	Nam-Quang Tran	[dcda0a] Minor change in build scripts.
build-website.py	2022-07-31	Nam-Quang Tran	[dcda0a] Minor change in build scripts.
build-win-installer.nsi	2024-04-23	Nam-Quang Tran	[5a356c] File mode changes (removed executable flags).
build.py	2020-10-19	Nam-Quang Tran	[47bf34] Various minor changes.
current-version.txt	2021-05-25	Nam-Quang Tran	[e0da4b] Version 1.1.25.
deploy-website.sh	2018-06-19	Nam-Quang Tran	[09cd2b] Website deployment script now sets correct file...
readme.txt	2021-03-21	Nam-Quang Tran	[a907d5] Minor change in folder watcher.

Read Me

#===============================================================================
#	Setup in Eclipse
#===============================================================================
- Get Eclipse (tested with v4.3, Java Developers edition)
- Import the DocFetcher folder into your Eclipse workspace
- In Eclipse Preferences > Java > Build Path > User Libraries: 
  create a User Library named 'SWT' which points to the right SWT jar for your
  platform. 
  The SWT jars can be found in "lib/swt". Optionally, the same
  "SWT" user library can also be used for overriding other 3rd party libs
  (for example, a local build of java-libpst-0.9.4-SNAPSHOT.jar).

In the Run configuration:
 - Main > Main class: net.sourceforge.docfetcher.gui.Application
 - Required Arguments > VM arguments
	Windows:
		-Djava.library.path="lib/jnotify;lib/jintellitype"
	Linux:
		-Djava.library.path="lib/jnotify:lib/jxgrabkey"
	Mac OS X:
		-Djava.library.path="lib/jnotify"
		-XstartOnFirstThread
 - Optional VM argument: -enableassertions
 - Classpath > add the folder "dist/lang" to the classpath (Advanced... > Add Folders).


#===============================================================================
#	Building DocFetcher from the console
#===============================================================================
- Requirements: Python and JDK 7.0+
- The bin folder of your JDK installation containing the various JDK binaries
  (javac, java, jar) has to be on your PATH variable. See:
  https://www.java.com/en/download/help/path.xml
- current-version.txt:
	- this file contains the version number used by all build scripts below
	- this file must not contain any extra whitespace or newlines
- build.py:
	- the main build file that builds DocFetcher
	- output is in the "build" folder
- build-win-installer.nsi
	- NSIS script for building the Windows installer
	- requires NSIS and must be run on Windows
	- requires NSIS plugins in dev/nsis-dependencies;
	  see installation instructions at the top of the .nsi file
	- must run build.py first before running this
	- output is in the "build" folder
- build-man.py:
	- recreates the manual
	- output is in dist/help
- build-website.py:
	- recreates the website
	- output is in dist/website
- build-dmg.sh:
	- builds a Mac OS X disk image
	- must run build.py first
	- must be run on Linux
	- requires program mkfs.hfsplus (try package hfsprogs on Ubuntu)
	- output is in the "build" folder
- build-daemon.xml:
	- Ant file for building the DocFetcher daemon
	- probably stopped working a long time ago
- deploy-website.sh:
	- deploys the website to the project webspace on SourceForge.net
	- will automatically run build-website.py
	- must specify SourceForge.net user name and password


#===============================================================================
#	The DocFetcher Launchers
#===============================================================================
The DocFetcher launchers for all platforms can be found under dist/launchers.
The DocFetcher.exe launchers in that folder have been created with Launch4J,
according to the settings in dev/launch4j-config.txt, and using the icon file
dev/DocFetcher.ico.