Difference between revisions of "Developer Documents"

From BRL-CAD
(talk about mime types)
(I'm interested in BRL-CAD development. How can I get involved?)
 
(47 intermediate revisions by 17 users not shown)
Line 1: Line 1:
= Projects under active development =
+
[[Category:Design Documents]]
 +
[[category:Projects]]
  
* [[libpg : A parametrics/constraint library]]
+
== Introduction ==
* [[Revolve Primitive]]
+
If you are going to contribute and wish to be the part of ongoing development of BRL-CAD, you are highly recommended to read following introductory article to let you know the current roadmap of the project.
* [[OpenGL GUI Framework]]
 
* [[Metropolis_Light_Transport|Global Illumination using Metropolis Light Transport]]
 
* [[Geometry Service]]
 
  
= Developer FAQ =
+
[[An Introduction To New Developers]]
  
== I'm trying to add a new file to the repository and I get an error on commit about mime types.  What do I do? ==
+
== Developer FAQ ==
  
You either set up your subversion config to auto-set mime types or you directly set the mime type on the file before you commit the file using svn propset.
+
=== I'm interested in BRL-CAD development. How can I get involved? ===
  
Sean provides a copy of his Subversion config file that accounts for many mime types. You can download and install it with this:
+
* Join the IRC channel #brlcad at irc.libera.chat and/or the [http://lists.sourceforge.net/lists/listinfo/brlcad-devel developer mailing list]
 +
* Read the [https://github.com/BRL-CAD/brlcad/blob/main/HACKING developer's guide]
 +
* Start submitting [https://github.com/BRL-CAD/brlcad/pulls pull requests]
  
'''curl http://brlcad.org/~sean/subversion.config > ~/.subversion/config'''
+
=== I'm trying to add a new file to the repository and I get an error on commit about mime types. What should I do? ===
  
This problem usually looks like this:
+
You should set the mime type. See [[mime-types]] for more information.
  
Transmitting file data ...svn: Commit failed (details follow):
+
== Developer Examples ==
svn: MERGE request failed on '/svnroot/brlcad/brlcad/trunk/regress'
+
 
svn: 'pre-commit' hook failed with error output:
+
* [[Example_libbu|Linking against a library]]
/var/local/mastertree/service-svn/hook-scripts/check-mime-type.pl:
+
* [[Example_db_walk_tree|Using db_walk_tree()]]
+
* [[GCV_Plugin_Tutorial]]
brlcad/trunk/regress/some_new_file.c : svn:mime-type is not set
+
* [[:Category:Code examples]]
+
 
+
== Development Tips ==
    Every added file must have the svn:mime-type property set. In
+
* [[Compiling]]
    addition text files must have the svn:eol-style property set.
+
* [[Emacs]]
   
+
* [[SVN+SSH]]
    For binary files try running
+
 
    svn propset svn:mime-type application/octet-stream path/of/file
+
== Development Projects ==
   
+
 
    For text files try
+
* [[Online Geometry]]
    svn propset svn:mime-type text/plain path/of/file
+
** [[OGV|Online Geometry Viewer Project]]
    svn propset svn:eol-style native path/of/file
+
*** [[OGV_on_FreeBSD]]
   
+
** [http://more.brlcad.org/ BRL-CAD Model Repository]
    You may want to consider uncommenting the auto-props section
+
* New GUI
    in your ~/.subversion/config file. Read the Subversion book
+
** [[OpenGL GUI Framework]]
    (http://svnbook.red-bean.com/), Chapter 7, Properties section,
+
* Geometry Engine / Server
    Automatic Property Setting subsection for more help.
+
** [[BRL-CAD's core C++ interface]]
 +
** [[Geometry Service]]
 +
*** [[Geometry_Service_Project_Main|Geometry Service Project]]
 +
* Geometry Conversion
 +
** [[ProE-BRL|Pro/ENGINEER to BRL-CAD export plugin]]
 +
** [[STEP|ISO 103030 STEP Geometry Conversion Support]]
 +
* Community Initiatives
 +
** [[Google Summer of Code]]
 +
** [[ESA Summer of Code in Space]]
 +
** [[Google Code In]]
 +
** [[Google_Doc_Camp|Google Doc Camp]]
 +
** [[Google Season of Docs]]
 +
* Out-of-date Orphans
 +
** [[libpg : A parametrics/constraint library]]
 +
** [[libpc | libpc : Geometric Constraint Solving]]

Latest revision as of 02:40, 8 February 2022


Introduction[edit]

If you are going to contribute and wish to be the part of ongoing development of BRL-CAD, you are highly recommended to read following introductory article to let you know the current roadmap of the project.

An Introduction To New Developers

Developer FAQ[edit]

I'm interested in BRL-CAD development. How can I get involved?[edit]

I'm trying to add a new file to the repository and I get an error on commit about mime types. What should I do?[edit]

You should set the mime type. See mime-types for more information.

Developer Examples[edit]

Development Tips[edit]

Development Projects[edit]