PLplotWiki - User contributions [en]

Subversion access

2008-09-10T21:07:05Z

Jerrybauck: /* Subversion Clients */

== Subversion Access ==

The PLplot Subversion repository can be checked out through SVN with the following instruction set:

<pre>
svn co https://plplot.svn.sourceforge.net/svnroot/plplot/trunk plplot
</pre>

You can browse the PLplot Subversion repository online at http://plplot.svn.sourceforge.net/viewvc/plplot/.

== Subversion Clients ==
* SvnX (Mac OS X): http://www.lachoseinteractive.net/en/community/subversion/svnx/features/
* Subcommander (Mac OS X): http://subcommander.tigris.org
* Versions (Mac OS X): http://www.versionsapp.com/
* TortoiseSVN (Windows): http://tortoisesvn.tigris.org/
* KDESvn (Linux): http://kdesvn.alwins-world.de/wiki

== Remarks ==
=== Setting file and directory svn properties ===
(Copied from a [http://www.mail-archive.com/plplot-devel@lists.sourceforge.net/msg00564.html post from Alan Irwin]).

The only general SVN maintainence left to do, that I am aware of, is to correct and maintain directory and file properties.
In general, cvs2svn set directory and file properties correctly for the existing files, but we should be aware of these property issues for newly created directories and files.

One directory property you should be aware of is the svn:ignore property which has the same function as .cvsignore did for CVS. (In fact, cvs2svn took the contents of .cvsignore and put it into this directory property. For example, if you look at the svn:ignore property for the src directory you will find the following list of file patterns which should seem familiar:

svn:ignore : *.flc
Makefile
Makefile.in
.deps
.libs
*.la
*.lo

In addition to the above directory property, there are several file properties you should be aware of. Files that are executable have the property

svn:executable : *

set which assures that the correct execute permission bit is set up for Unix systems on checkout. Apparently this property is set automatically for newly added files if their execute permission is set first.

Files that are text have the property

svn:eol-style : native

set so that everybody will get the right end-of-lines inserted into their text files on their platform of choice. The svn:eol-style property is the most important. See the discussion of that at http://svnbook.red-bean.com/en/1.0/ch07s02.html.

Files that are binary have the property

svn:mime-type : application/octet-stream

set and svn:eol-style is not set.

If you notice anything wrong in any of these respects (wrong files being ignored by subversion, incorrect execute permissions on checkout, wrong line endings, or corrupted binary files), please fix the problem by adjusting the properties as above. (See "svn help proplist" to see how to list properties for a file, and "svn help propedit" or "svn help propset" to find out how to
change properties to what you want.) And also, _please_ remember to specify these file properties for newly created files.

Note, that can be a bit of a burden for ordinary text files if you always have to remember to set "svn:eol-style : native" by hand. I just discovered a way to do this automatically (and also do the right thing for some common binary files) if you edit the auto-props section of $HOME/.subversion/config. That section sets properties of newly added files based on file-globbing patterns.

Here is my new file-globbing setup in that file. (You also have to enable auto-props in that same file.)

* = svn:eol-style=native
*.png = svn:mime-type=application/octet-stream
*.jpg = svn:mime-type=application/octet-stream
*.jpeg = svn:mime-type=application/octet-stream
*.gif = svn:mime-type=application/octet-stream

After implementing the above change, I then did the following to test it:

touch test.png
touch test
svn add test*
svn proplist --verbose test*
Properties on 'test':
svn:eol-style : native
Properties on 'test.png':
svn:mime-type : application/octet-stream

which is exactly the file properties we want so I suggest you use the same setup to make svn life really easy for you.

The above chapter in http://svnbook.red-bean.com/en/1.0/ch07s02.html has additional information about properties that should be useful as well. For example, one should be able to configure your svn client so one don't have to worry about setting properties by hand.

See "Automatic Property Setting" in that same chapter. That works well for me in a Linux environment, but one will have to read further to see whether it will work in windows.

=== Automatic property setting in TortoiseSVN ===
In order to set the properties automatically in TortoiseSVN (Windows), right click in the Windows explorer and choose 'TortoiseSVN->Settings'. In the 'General' tab choose 'Edit' Subversion configuration style. The NotePad pops up with the config file and change the following settings:

* uncomment <tt>enable-auto-props = yes</tt>

in the <nowiki>[miscellany]</nowiki>. In the <nowiki>[auto-props]</nowiki> section add the properties from above

* = svn:eol-style=native;svn:keywords=Author Date Id Revision
*.png = svn:mime-type=application/octet-stream
*.jpg = svn:mime-type=application/octet-stream
*.jpeg = svn:mime-type=application/octet-stream
*.gif = svn:mime-type=application/octet-stream

CMake options for PLplot

2008-09-10T20:56:10Z

Jerrybauck: /* Bindings options */

A large number of options are available to modify the CMake configuration process. Use the ccmake command to obtain documentation of all of them. Here we give the documentation of the most heavily used subset of the options. The value specified is the default value, but note that value can automatically be changed by the build system if some essential resource is not available on the platform. For example, if no Fortran 95-capable compiler can be found on the platform, the Fortran 95 bindings are automatically disabled. Furthermore, certain option values depend on other option values. For example, if BUILD_SHARED_LIBS is set to OFF, then ENABLE_DYNDRIVERS is automatically set to OFF as well.

In general, if you just use the default options PLplot will normally configure itself to build without problems. The cmake output will have WARNING messages about any missing components. If one of those is important to you, then you will have to install additional libraries or executables (e.g., a Fortran 95-capable compiler) and do a fresh cmake run in an empty directory to configure a PLplot build that includes the component that was missing before.

== General options ==

'''CMAKE_INSTALL_PREFIX:PATH'''=/usr/local - install directory

'''CMAKE_BUILD_TYPE:STRING'''=Release/Debug - release or debug build of plplot

'''BUILD_SHARED_LIBS:BOOL'''=ON - build shared libraries (ON) or static libraries (OFF)

'''ENABLE_DYNDRIVERS:BOOL'''=ON - build device drivers as dynamically loaded plugins (ON) or as part of the PLplot core C library (OFF)

'''BUILD_TEST:BOOL'''=OFF - builds examples in the build tree so that ctest can be run afterward to test that those examples work

'''PL_DOUBLE:BOOL'''=ON - use 64-bit (ON) or 32-bit (OFF) floating-point precision

'''WITH_CSA:BOOL'''=ON - internally build and use the csirocsa library for bivariate cubic spline approximation

'''BUILD_DOC:BOOL'''=OFF - build documentation (Linux only)

== Bindings options ==

'''DEFAULT_NO_BINDINGS:BOOL'''=OFF - turn off all language bindings by default

'''ENABLE_cxx:BOOL'''=ON - C++ bindings

'''ENABLE_f77:BOOL'''=ON - Fortran 77 bindings

'''ENABLE_f95:BOOL'''=ON - Fortran 95 bindings

'''ENABLE_python:BOOL'''=ON - Python bindings

'''ENABLE_java:BOOL'''=ON - Java bindings

'''ENABLE_tcl:BOOL'''=ON - Tcl bindings

'''ENABLE_itcl:BOOL'''=ON - iTcl object-oriented extension of the Tcl bindings

'''ENABLE_tk:BOOL'''=ON - Tk (graphical extension of Tcl) bindings

'''ENABLE_itk:BOOL'''=ON - iTk object-oriented extension of the Tk bindings

'''ENABLE_ada:BOOL'''=ON - Ada 95 and Ada 2005 bindings

'''ENABLE_pdl:BOOL'''=OFF - include PDL (Perl Data Language) examples to be used with PDL PLplot bindings that are developed as part of the external PDL project

'''ENABLE_d:BOOL'''=OFF - Experimental [http://www.digitalmars.com/d/index.html D] bindings

'''ENABLE_ocaml:BOOL'''=OFF - Experimental [http://caml.inria.fr/ OCaml] bindings

== Device options ==

=== General device options ===
'''DEFAULT_ALL_DEVICES:BOOL'''=OFF

'''DEFAULT_NO_DEVICES:BOOL'''=OFF

'''WITH_FREETYPE:BOOL'''=ON - access TrueType fonts with direct calls to libfreetype for certain device drivers that use this method of accessing TrueType fonts.

=== libpango/libcairo-related devices ===
These devices use various cairo backends. The ones that are turned ON by default generally give beautiful results with properly hinted fonts. The others do not yet work well for the present (2007-12) state of cairo backend development but may work well in the future.

'''PLD_pscairo'''=ON

'''PLD_pdfcairo'''=ON

'''PLD_pngcairo'''=ON

'''PLD_xcairo'''=ON

'''PLD_svgcairo'''=OFF

'''PLD_memcairo'''=OFF

=== libgd-related devices ===
'''PLD_png:BOOL'''=ON

'''PLD_jpeg:BOOL'''=ON

'''PLD_gif:BOOL'''=ON

=== Hewlett-Packard printer devices ===
'''PLD_hp7470:BOOL'''=ON

'''PLD_hp7580:BOOL'''=ON

'''PLD_lj_hpgl:BOOL'''=ON

=== Textronix and Textronix emulator devices ===
'''PLD_xterm:BOOL'''=OFF

'''PLD_tek4010:BOOL'''=OFF

'''PLD_tek4010f:BOOL'''=OFF

'''PLD_tek4107:BOOL'''=OFF

'''PLD_tek4107f:BOOL'''=OFF

'''PLD_mskermit:BOOL'''=OFF

'''PLD_versaterm:BOOL'''=OFF

'''PLD_vlt:BOOL'''=OFF

'''PLD_conex:BOOL'''=OFF

=== Other devices ===
'''PLD_aqt:BOOL'''=ON

'''PLD_cgm:BOOL'''=ON

'''PLD_dg300:BOOL'''=OFF

'''PLD_gcw:BOOL'''=ON

'''PLD_imp:BOOL'''=OFF

'''PLD_linuxvga:BOOL'''=OFF

'''PLD_ljii:BOOL'''=OFF

'''PLD_ljiip:BOOL'''=OFF

'''PLD_mem:BOOL'''=ON

'''PLD_ntk:BOOL'''=OFF

'''PLD_null:BOOL'''=ON

'''PLD_pbm:BOOL'''=ON

'''PLD_pdf:BOOL'''=OFF

'''PLD_plmeta:BOOL'''=OFF

'''PLD_ps:BOOL'''=ON

'''PLD_pstex:BOOL'''=OFF

'''PLD_psttf:BOOL'''=ON

'''PLD_svg:BOOL'''=ON

'''PLD_tk:BOOL'''=ON

'''PLD_tkwin:BOOL'''=ON

'''PLD_wingcc:BOOL'''=ON

'''PLD_wxwidgets:BOOL'''=ON

'''PLD_xfig:BOOL'''=ON

'''PLD_xwin:BOOL'''=ON