Sources - Revision history

JaroslavTulach: /* Funny Stories */

JaroslavTulach — Sun, 09 Nov 2025 10:14:35 GMT

Funny Stories

←Older revision		Revision as of 10:14, 9 November 2025
Line 39:		Line 39:
	My [[Hudson]] server crashed in early months of 2014. I had to configure it from scratch. While doing so, I forgot to configure the job to produce ''apidesign.zip'' file with [[sources]]. Has anyone noticed? Nobody sent me an email! Just yesterday Jáchym, my co-worker, who I torture by forcing him to read [[TheAPIBook]] and become [[good]] [[API]] designer, stopped in my office and timidly asked: ''Where can I get the sources? There is no [[ZIP]] file!''		My [[Hudson]] server crashed in early months of 2014. I had to configure it from scratch. While doing so, I forgot to configure the job to produce ''apidesign.zip'' file with [[sources]]. Has anyone noticed? Nobody sent me an email! Just yesterday Jáchym, my co-worker, who I torture by forcing him to read [[TheAPIBook]] and become [[good]] [[API]] designer, stopped in my office and timidly asked: ''Where can I get the sources? There is no [[ZIP]] file!''

-	For a while I tried to blame him for not using [[Mercurial]], but after a while I realized the problem is on my side. As a result, the [http://hudson.apidesign.org/job/samples/ zip file with sources] is back as of Aug 8, 2014. Will anyone use them? It would be nice as reading [[TheAPIBook\|Practical API Design]] book without having whole [[sources]] at your hand is like trying to understand [[Swing]] just by reading its [[Javadoc]].	+	For a while I tried to blame him for not using [[Mercurial]], but after a while I realized the problem is on my side. As a result, the [http://hudson.apidesign.org/job/samples/lastSuccessfulBuild/artifact/snippets.zip zip file with sources] is back as of Aug 8, 2014. Will anyone use them? It would be nice as reading [[TheAPIBook\|Practical API Design]] book without having whole [[sources]] at your hand is like trying to understand [[Swing]] just by reading its [[Javadoc]].

	Let me know (Jáchym, you have to) whether you found the [[sources]] useful.		Let me know (Jáchym, you have to) whether you found the [[sources]] useful.

JaroslavTulach: /* Download */

JaroslavTulach — Sun, 09 Nov 2025 10:14:20 GMT

Download

←Older revision		Revision as of 10:14, 9 November 2025
Line 20:		Line 20:

	Those that prefer [[ZIP]] over [[Mercurial]] (for example to get also all necessary libraries with the [[sources]]) can download the latest published build from our		Those that prefer [[ZIP]] over [[Mercurial]] (for example to get also all necessary libraries with the [[sources]]) can download the latest published build from our
-	[http://hudson.apidesign.org/job/samples continuous build server]. Download the latest version of apidesign.zip, unzip it on your local computer. Start [[NetBeans]] IDE and open individual projects as needed.	+	[http://hudson.apidesign.org/job/samples/lastSuccessfulBuild/artifact/snippets.zip continuous build server]. Download the latest version of apidesign.zip, unzip it on your local computer. Start [[NetBeans]] IDE and open individual projects as needed.

	=== Usage ===		=== Usage ===

JaroslavTulach at 04:39, 8 February 2025

JaroslavTulach — Sat, 08 Feb 2025 04:39:43 GMT

←Older revision		Revision as of 04:39, 8 February 2025
Line 41:		Line 41:
	For a while I tried to blame him for not using [[Mercurial]], but after a while I realized the problem is on my side. As a result, the [http://hudson.apidesign.org/job/samples/ zip file with sources] is back as of Aug 8, 2014. Will anyone use them? It would be nice as reading [[TheAPIBook\|Practical API Design]] book without having whole [[sources]] at your hand is like trying to understand [[Swing]] just by reading its [[Javadoc]].		For a while I tried to blame him for not using [[Mercurial]], but after a while I realized the problem is on my side. As a result, the [http://hudson.apidesign.org/job/samples/ zip file with sources] is back as of Aug 8, 2014. Will anyone use them? It would be nice as reading [[TheAPIBook\|Practical API Design]] book without having whole [[sources]] at your hand is like trying to understand [[Swing]] just by reading its [[Javadoc]].

-	Let me know (Jáchym, you have to) whether you found the [[sources]] useful.	+	Let me know (Jáchym, you have to) whether you found the [[sources]] useful.
-		+
-	~~<comments/>~~	+

JaroslavTulach at 04:40, 19 January 2025

JaroslavTulach — Sun, 19 Jan 2025 04:40:21 GMT

←Older revision		Revision as of 04:40, 19 January 2025
Line 11:		Line 11:

	In order to use the sample [[sources]] you may need:		In order to use the sample [[sources]] you may need:
-	* At least [[JDK]]7 or [[JDK]8 - necessary for compilation and execution	+	* At least [[JDK]]7 or [[JDK]]8 - necessary for compilation and execution
	* At least [[Ant]] 1.8.1 - allows simple compilation and execution from command line		* At least [[Ant]] 1.8.1 - allows simple compilation and execution from command line
	* At least [[NetBeans]] IDE 6.9 - all projects are configured to smoothly open in [[NetBeans]] IDE		* At least [[NetBeans]] IDE 6.9 - all projects are configured to smoothly open in [[NetBeans]] IDE

JaroslavTulach: /* Usage */

JaroslavTulach — Thu, 30 Oct 2014 20:50:37 GMT

Usage

←Older revision		Revision as of 20:50, 30 October 2014
Line 26:		Line 26:
	It is always better to build the root project:		It is always better to build the root project:
	<source lang="bash">		<source lang="bash">
-	$ cd samples	+	$ cd samples # in case of [[Mercurial]] checkout
	$ ant build.xml # or from the IDE		$ ant build.xml # or from the IDE
	</source>		</source>
	before opening its sub-projects in the IDE. Failing to do so may cause the projects to show ''broken references'' (due to missing [[libraries]] that need to be downloaded first in the [[Mercurial]] case). Btw. in case you need to perform really clean build and download all [[libraries]] once again, you can		before opening its sub-projects in the IDE. Failing to do so may cause the projects to show ''broken references'' (due to missing [[libraries]] that need to be downloaded first in the [[Mercurial]] case). Btw. in case you need to perform really clean build and download all [[libraries]] once again, you can
	<source lang="bash">		<source lang="bash">
-	$ cd samples	+	$ cd samples # in case of [[Mercurial]] checkout
	$ rm -r libs/dist		$ rm -r libs/dist
	</source>		</source>

JaroslavTulach: /* Usage */

JaroslavTulach — Thu, 30 Oct 2014 20:47:14 GMT

Usage

←Older revision		Revision as of 20:47, 30 October 2014
Line 26:		Line 26:
	It is always better to build the root project:		It is always better to build the root project:
	<source lang="bash">		<source lang="bash">
		+	$ cd samples
	$ ant build.xml # or from the IDE		$ ant build.xml # or from the IDE
	</source>		</source>
-	before opening its sub-projects in the IDE. Failing to do so may cause the projects to show ''broken references'' (due to missing [[libraries]] that need to be downloaded first in the [[Mercurial]] case).	+	before opening its sub-projects in the IDE. Failing to do so may cause the projects to show ''broken references'' (due to missing [[libraries]] that need to be downloaded first in the [[Mercurial]] case). Btw. in case you need to perform really clean build and download all [[libraries]] once again, you can
		+	<source lang="bash">
		+	$ cd samples
		+	$ rm -r libs/dist
		+	</source>

	=== Funny Stories ===		=== Funny Stories ===

JaroslavTulach: /* Environment */

JaroslavTulach — Thu, 30 Oct 2014 20:45:41 GMT

Environment

←Older revision		Revision as of 20:45, 30 October 2014
Line 11:		Line 11:

	In order to use the sample [[sources]] you may need:		In order to use the sample [[sources]] you may need:
-	* At least [[JDK]] ~~1.6.0~~ - necessary for compilation and execution	+	* At least [[JDK]]7 or [[JDK]8 - necessary for compilation and execution
	* At least [[Ant]] 1.8.1 - allows simple compilation and execution from command line		* At least [[Ant]] 1.8.1 - allows simple compilation and execution from command line
	* At least [[NetBeans]] IDE 6.9 - all projects are configured to smoothly open in [[NetBeans]] IDE		* At least [[NetBeans]] IDE 6.9 - all projects are configured to smoothly open in [[NetBeans]] IDE

JaroslavTulach: /* Usage */

JaroslavTulach — Fri, 08 Aug 2014 11:14:18 GMT

Usage

←Older revision		Revision as of 11:14, 8 August 2014
Line 24:		Line 24:
	=== Usage ===		=== Usage ===

-	~~You need~~ to build the root project:	+	It is always better to build the root project:
	<source lang="bash">		<source lang="bash">
	$ ant build.xml # or from the IDE		$ ant build.xml # or from the IDE
	</source>		</source>
-	before opening its sub-projects in the IDE. Failing to do so may cause the projects to show ''broken references'' (due to missing [[libraries]] that need to be downloaded first).	+	before opening its sub-projects in the IDE. Failing to do so may cause the projects to show ''broken references'' (due to missing [[libraries]] that need to be downloaded first in the [[Mercurial]] case).
		+
		+	=== Funny Stories ===
		+
		+	My [[Hudson]] server crashed in early months of 2014. I had to configure it from scratch. While doing so, I forgot to configure the job to produce ''apidesign.zip'' file with [[sources]]. Has anyone noticed? Nobody sent me an email! Just yesterday Jáchym, my co-worker, who I torture by forcing him to read [[TheAPIBook]] and become [[good]] [[API]] designer, stopped in my office and timidly asked: ''Where can I get the sources? There is no [[ZIP]] file!''
		+
		+	For a while I tried to blame him for not using [[Mercurial]], but after a while I realized the problem is on my side. As a result, the [http://hudson.apidesign.org/job/samples/ zip file with sources] is back as of Aug 8, 2014. Will anyone use them? It would be nice as reading [[TheAPIBook\|Practical API Design]] book without having whole [[sources]] at your hand is like trying to understand [[Swing]] just by reading its [[Javadoc]].
		+
		+	Let me know (Jáchym, you have to) whether you found the [[sources]] useful.
		+
		+	<comments/>

JaroslavTulach at 11:03, 8 August 2014

JaroslavTulach — Fri, 08 Aug 2014 11:03:42 GMT

←Older revision		Revision as of 11:03, 8 August 2014
Line 2:		Line 2:
	are extracted from real projects. As such it is guaranteed they are correct, they compile and can even be executed, [[debugger\|debugged]] and tested.		are extracted from real projects. As such it is guaranteed they are correct, they compile and can even be executed, [[debugger\|debugged]] and tested.

-	Moreover, as it is often not enough to see just a few lines of code in middle of a page, readers are recommended to get the whole tree of [[sources]], including their history and play with them for real. Preferably use [[Mercurial]] to clone the [[sources]] [[Hg]] [http://source.apidesign.org/hg/apidesign/ repository]:	+	Moreover, it is often not enough to see just a few lines of code in middle of a page, readers are recommended to get the whole tree of [[sources]], including their history and play with them for real. Preferably use [[Mercurial]] to clone the [[sources]] [[Hg]] [http://source.apidesign.org/hg/apidesign/ repository]:

	<source lang="bash">		<source lang="bash">

JaroslavTulach: /* Download */

JaroslavTulach — Fri, 08 Aug 2014 11:03:07 GMT

Download

←Older revision		Revision as of 11:03, 8 August 2014
Line 19:		Line 19:
	=== Download ===		=== Download ===

-	Those that prefer [[ZIP]] over [[Mercurial]] (~~which~~ [[I]] ~~don't understand~~) can download the latest published build from our	+	Those that prefer [[ZIP]] over [[Mercurial]] (for example to get also all necessary libraries with the [[sources]]) can download the latest published build from our
-	[http://hudson.apidesign.org/job/samples continuous build server]. Download the latest version of apidesign~~-XYZ~~.zip, unzip it on your local computer. Start [[NetBeans]] IDE and open individual projects as needed.	+	[http://hudson.apidesign.org/job/samples continuous build server]. Download the latest version of apidesign.zip, unzip it on your local computer. Start [[NetBeans]] IDE and open individual projects as needed.
-		+

	=== Usage ===		=== Usage ===