Difference between revisions of "Deuces"
(update →Outreach and Research: tasks) |
(→Create an ISST screenshot or animation) |
||
Line 661: | Line 661: | ||
Everyone loves to see screenshots and animations of software in action. We use both in our marketing and outreach. See some of the examples below that we already have. | Everyone loves to see screenshots and animations of software in action. We use both in our marketing and outreach. See some of the examples below that we already have. | ||
− | Create an awesome screenshot and/or animation of our 'isst' tool in action. It's an interactive geometry viewer interface. It should be graphically interesting and give some sense of capability. You should import a visually complex and interesting model with LOTS of polygons and detail. | + | Create an awesome screenshot and/or animation of our 'isst' tool in action. It's an interactive geometry viewer interface. It should be graphically interesting and give some sense of capability. You should import a visually complex and interesting model with LOTS of polygons and detail. Note you may have to go through some or the MGED tutorials (see Docs on our website). |
References: | References: | ||
− | |||
− | |||
* https://brlcad.org/gallery/index.php?/category/12 | * https://brlcad.org/gallery/index.php?/category/12 | ||
− | |||
− | |||
− | |||
| | ||
Line 677: | Line 672: | ||
{| style="background-color:#fefefe; border-style: solid; border-width: 4px;" width="100%" | {| style="background-color:#fefefe; border-style: solid; border-width: 4px;" width="100%" | ||
| style="padding: 20px;" | | | style="padding: 20px;" | | ||
+ | |||
=== Categorize all of BRL-CAD's commands into a spreadsheet === | === Categorize all of BRL-CAD's commands into a spreadsheet === | ||
Revision as of 20:29, 28 October 2020
Below are tasks that are a great starting point for anyone interested in contributing to BRL-CAD. Most tasks can be completed in just a couple hours! No prior experience with BRL-CAD is required.
Some tasks may take longer if you aren't set up or haven't done that type before, but all they all require about the same amount of experienced effort. Each task has a description, references, and list of files you'll probably need. Can we make it any easier? Let us know.
Get Set Up
We suggest you compile BRL-CAD yourself or, if you have trouble with that, there's a virtual image with everything preconfigured, ready to go:
- Download our BRL-CAD Virtual Machine (VM) disk image.
- Install VirtualBox.
- Import the disk image, start the VM, and log in (password is "Brlcad!" without quotes).
- Run "svn up brlcad-svn-trunk" and compile.
Pick a Task
Once set up, select any task that sounds interesting, read the references, and talk with us for help. Don't worry if some words are confusing. You got this. All tasks can be completed by anyone but are grouped into the following five interest categories:
- Code (programming)
- Documentation and Training (technical writing)
- Outreach and Research (graphics, marketing)
- Quality Assurance (testing)
- User Interface (usability, design)
Contents
- 1 Get Set Up
- 2 Pick a Task
- 2.1 Code
- 2.2 Documentation and Training
- 2.2.1 Add missing documentation (for any ONE command)
- 2.2.2 Complete our "Intro to BRL-CAD Modeling" tutorial and extend it
- 2.2.3 Translate "Contributors Guide To BRL-CAD" To Any Language
- 2.2.4 Write a "BRL-CAD Commands Quick Reference" document
- 2.2.5 Doxygen cleanup
- 2.2.6 Add images to our wiki page on Volumetric objects
- 2.2.7 Fix Image Formatting in BRL-CAD's DocBook Documentation (any ONE large document or 4 smaller documents)
- 2.2.8 Find 5 bugs in OGV
- 2.3 Outreach and Research
- 2.4 Quality Assurance
- 2.5 User Interface
- 2.5.1 Create an ISST screenshot or animation
- 2.5.2 Categorize all of BRL-CAD's commands into a spreadsheet
- 2.5.3 Design a Cover Photo for Facebook page (and other social networks)
- 2.5.4 Design a banner ad for BRL-CAD
- 2.5.5 Creating Motion Typography video for BRL-CAD
- 2.5.6 Create a screen-cast for BRL-CAD
- 2.5.7 Loading Google charts from API
- 2.5.8 Design a hall of fame for BRL-CAD developers
- 3 When You're Done
Code
Tasks related to writing or refactoring code
See the When You're Done section above for details on submitting your changes.
Close MGED only when both windows are closedBRL-CAD has an interactive geometry editor called MGED. It's often the starting point for beginners and allows creation and manipulation of models using commands. When mged is run, it creates 2 windows: a text console for commands and an interactive graphics window. Currently, if you close the graphics window, it quits the application. This task involves change behavior so that MGED exits only after closing both windows. Closing just the graphics window or text console should not quit MGED. Code:
|
Implement a primitive centroid functionBRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones. Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid. Wikipedia, Wolfram Mathworld, and various other math sites (and research papers) around the web include the equations for most of our basic primitives while others are more tricky to compute. This task involves writing a new callback function that takes an rt_db_internal object and calculates its centroid (as a point_t 3D point). There are numerous examples in our code where we compute centroids for other primitives. The primitives that do not already have a centroid callback are itemized in following. References:
Code:
|
Implement a primitive curvature functionBRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones each described by a collection of callback functions, for example rt_sph_bbox() returns the bounding box dimensions for a sphere. Wikipedia, Wolfram Mathworld, and various other math sites (and research papers) around the web include the equations for most of our basic primitives while others are a little more tricky to compute. This task involves writing the callback function rt_xxx_curve() that computes the curvature at a given point on the surface of a primitive such as;
There are numerous examples in our code where we compute the curvature for other primitives like the ellipsoid, sphere, elliptical parabola, etc. References:
Code:
|
Implement a primitive UV-mapping callbackBRL-CAD provides more than two dozen types of geometry "primitives" such as ellipsoids, boxes, and cones. Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid. One of those functions describes a UV mapping of the object's surface, which is used for things like texture and bump mapping. An example of this is rt_ell_uv() in the src/librt/primitives/ell/ell.c source file for an ellipsoid. Several of our more complex primitive types (such as BoT, NMG, and BREP/NURBS) do not presently implement a UV-mapping function leading to unexpected runtime behavior. This task involves implementing a UV-mapping callback for any of the primitives that do not already have a functional UV-callback defined. Note that this is an advanced task that might take you more than a couple hours if you don't have solid coding skills, but it's ultimately just a few lines of code. See other primitives that already implement a UV-mapping callback for reference. References:
Code:
|
Documentation and Training
Tasks related to creating/editing documents and helping others learn more about BRL-CAD
Add missing documentation (for any ONE command)BRL-CAD is an extensive system with more than 400 commands and more than a million pages of documentation, but there are approximately 120 commands that are entirely undocumented: a-d archer asc2g asc2pix bot-bldxf bottest brep_cube brep_simple brickwall btclsh burst bw-a bw-d bwish c-d chan_add clutter contours d-a damdf dauto dauto2 d-bw dconv ddisp d-f dfft d-i dmod double-asc dpeak dsel dsp_add dstat d-u dwin euclid_format euclid_unformat fbgammamod f-d fence fhor f-i g-adrt g-euclid1 g-jack globe g-off i-a i-d i-f ihist imod istat jack-g kurt lowp molecule nmgmodel nmg-sgp off-g pipe pipetest pix2g pix3filter pixcount pixelswap pixembed pixfields pixfieldsep pixflip-fb pixpaste pix-spm pix-yuv plstat pyramid rawbot remapid rlesortmap rletovcr room rtcell rtexample rtfrac rtrad rtsil rtsrv script-tab sketch solshoot sphflake spltest spm-fb ssampview syn tea tea_nmg testfree texturescale torii ttcp tube txyz-pl u-a u-bw u-d u-f umod ustat vcrtorle vegitation wall wdb_example xbmtorle xyz-pl yuv-pix This task involves writing basic documentation for JUST ONE of those commands in the Docbook XML format. The command documentation should provide a one-sentence description, a detailed paragraph description (200+ words), explanation of all available command-line options, and one or more examples on how to use the command. Code:
|
Complete our "Intro to BRL-CAD Modeling" tutorial and extend itWe've developed two short and simple tutorials for introducing new users to modeling with BRL-CAD. This task involves doing one of the tutorials (they take about an hour) and then extending it with a new section or making some other improvement. At the end of the tutorial are several optional advanced "exercise left to the reader", for example. Write a half-page step-by-step for one of the exercises left to the reader. Include screenshots and images to make it look nice so the reader is not bored. Reference:
|
Translate "Contributors Guide To BRL-CAD" To Any LanguagePeople interested in improving BRL-CAD sometimes find themselves lost in a sea of information. In all, BRL-CAD has more than a million words of documentation across hundreds of manual pages, dozens of tutorials and examples, hundreds of wiki pages, dozens of technical papers, and other resources. There are literally thousands of features and this can sometimes pose problems. In 2013, a team of contributors got to California and worked on an entire book titled "Contributors Guide To BRL-CAD" in just a few days. This great resource needs to be translated to other languages to attract developers from other lingual backgrounds (who don't read English ) to contribute to BRL-CAD. This task involves translating the chapters/sections of the "Contributors Guide To BRL-CAD" into a language of your choice such as Mandarin, French, Chinese, Spanish, German, Hindi, Arabic, Russian, etc. Chapters/Sections include
The output of this task can be a pdf, html, doc, odt or any other document file that contains the translated article.Images in the original document (see link in Reference below) should not be changed ! only text should be. Reference:
|
Write a "BRL-CAD Commands Quick Reference" documentThere is already a command quick reference for BRL-CAD's MGED geometry editing tool, but there is not a similar document for BRL-CAD's 400+ command-line commands. This task involves writing a quick reference document similar to the MGED quick reference but for BRL-CAD commands. The sheet should minimally include the following commands: mged, rt*, *-g, g-*, fb*, *fb, nirt, remrt, rtsrv, asc2g, g2asc, dbupgrade, pix*, *pix, *-*, brlman, benchmark References:
|
Doxygen cleanupBRL-CAD uses Doxygen for most API documentation but the comment blocks are not optimally set up for Doxygen output. This task involves cleaning up the Doxygen comments in the library so that useful reports and API documentation automatically generated (correctly, completely, and cleanly). Verify/fix any Doxygen syntax. Verify/fix groups so that functions are organized neatly and all contained within a group. Provide patches that give clean (PDF) output from Doxygen. References:
|
Add images to our wiki page on Volumetric objectsBRL-CAD provides a couple dozen distinct primitives. Each primitive is defined by a set of parameters. Several of the more complex primitives have a wiki page describing them in more detail with an example on how to create them. This task involves adding images to our page for the VOL primitive. You'll need to first complete the tutorial and save images for each step. Add the images to the wiki page. References:
|
Fix Image Formatting in BRL-CAD's DocBook Documentation (any ONE large document or 4 smaller documents)The majority of BRL-CAD's documentation is defined as DocBook files, from which other formats (HTML, PDF, man page, etc.) can be generated. PDF files present a particular challenge, and have some very specific requirements to achieve "good" formatting. BRL-CAD's DocBook files need to uniformly use a style of image inclusion that is aware of what "role" the image is supposed to serve. A "basic" image inclusion example looks like this: <mediaobject> <imageobject> <imagedata align="center" fileref="../../lessons/en/images/img.png" format="PNG"/> </imageobject> <caption> <para> Caption goes here. </para> </mediaobject> This task involves switching image inclusions that use the above style to something like the following: <mediaobject> <imageobject role="html"> <imagedata align="center" fileref="../../books/en/images/img.png" format="PNG"/> </imageobject> <imageobject role="fo"> <imagedata align="center" fileref="../../books/en/images/img.png" format="PNG"/> </imageobject> <caption> <para> Caption goes here. </para> </mediaobject> The "role" flag to imageobject provides the opportunity to specify different image formatting options when the output is HTML (role="html") or PDF (role="fo"). The captions should be preserved as above on mediaobjects that have them, but mediaobjects without a caption should also be converted and there is no need to add a caption in such cases. Any patch that makes changes to the DocBook sources should result in a successful "make doc" build test. This won't generate PDF documents, but it will validate the XML files and produce HTML - remember that introducing breakage means the patch won't be accepted. Remember, the tasks are simply to do the above conversion for all images in the file or files, not to introduce PDF specific formatting. Formatting fixes will be needed, but they are very much "case by case" and will take both additional time and a working Apache FOP installation, as well as knowledge of how to enable PDF generation. If all image inclusions have been converted successfully and a student is interested in actually fixing the formatting, please discuss it with us on IRC or the mailing list. References:
Code:
|
Find 5 bugs in OGVOnline Geometry Viewer is a web based application with which you can see 3D .g models in browser without the use of any plugins. Your task will be to deploy OGV locally and find 5 bugs or errors in it. Links: https://github.com/BRL-CAD/OGV-meteor/
|
Outreach and Research
Tasks related to community management, outreach/marketing, studying problems, and recommending solutions
Profile NURBS prep performanceBRL-CAD implements support for rendering of NURBS representation geometry. If you import a solid 3DM or STEP format model into BRL-CAD, it will import as BREP/NURBS geometry. Opening that geometry in BRL-CAD's MGED editor will tell you what objects are available and our 'rt' tool will raytrace it. When geometry is ray traced, it first goes through a "prep" phase and then it starts shooting rays. Our prep phase is entirely unoptimized so we'd like to know where all the time is presently being spent during prep.. This task involves importing some NURBS geometry into BRL-CAD and ray tracing that geometry with a profiler watching our prep performance. Any profiler will do, including gprof, but a performance monitor like oprofile or the Mac "Instruments" application (or Shark) are preferred. Learning how to use a profiler is beyond the scope of this task, so it make take you considerably longer to provide us with useful information if you've never run a profiler before. To capture prep performance, you will need to import some fairly complex geometry. You should be able to search google with "filetype:3dm" or "filetype:step" or find something on grabcad.com to import Running "tops" within mged will tell you what geometry is available for rendering. Running "rt -o file.png -s32" on the system command line (not inside mged) should minimize the ray overhead or you can specifically isolate the prep phase we care about. Prep is the time between when rt is run where it opens a window until the first pixels are fired and pixels start filling in.
|
Continue investigating GMP integrationBRL-CAD uses a fastf_t typedef for most all math operations that is usually a "double" floating point type. We would like to provide the option for resorting to exact arithmetic if possible by merely redefining fastf_t to a C++ type sufficiently overloaded to behave the same. You should be proficient with C++ operator overloading to take this work on. This task is a continuation of a prior GCI task (read it in full!): http://www.google-melange.com/gci/task/view/google/gci2012/7946218 This task involves testing compilation with a C++ class with overloaded operators such that vmath macro calls still work as well as a sampling of LIBBN API function calls without major changes to the original code. A perfect example case study would be creating the class then testing whether bn_dist_pt3_pt3() and bn_mat_determinant() compute correctly for values that cannot be exactly represented with floating point arithmetic. Building on the previous GCI task work, take it to the next step. Try setting a vector to 1/3, 1/3, 1/3 and 0.1, 0.1, 0.1 and get proper values to print. Change the V3ARGS() macro if needed. If that all works, try to get bn_dist_pt3_pt3() to work. Report and discuss your progress.
|
Design a T-Shirt for BRL-CADThis task involves designing a T-Shirt for BRL-CAD. Use your designing skills to design a T-Shirt for BRL-CAD. You can use the current BRL-CAD logo, or you may tweak it. Be creative while designing this T-Shirt. It would be good if the design has some special meaning. Logo References
|
Design a coffee mug for BRL-CADThis task involves designing a coffee mug for BRL-CAD. Make it look good or at least interesting, and make it in BRL-CAD. Look over some coffee mug designs before starting to work on this. Verify that your mug is valid geometry by running the "rtcheck" command. Logo References
|
Design BRL-CAD stickerThis task involves designing a BRL-CAD sticker. The design should be simple and sleek. The concept of sticker should be clear and also it should be creatively presented. Get inspired from some sticker designs but choose your own imagination while designing the sticker. There is no bound for shape of sticker, it can be rectangular, circular or even irregular. The only thing that matters is that it should look good. Logo References
|
Design a wallpaper / desktop image for BRL-CADThis task involves designing a desktop background for BRL-CAD enthusiasts. The main idea of your wallpaper should be to showcase one or more features of BRL-CAD. Be intentional and able to defend/describe your choice of color, layout, and other aspects of the wallpaper design. Try to make sure the wallpaper works across a broad selection of screen resolutions. Search the web for wallpapers inspiration such as: Logo References
|
Model a Lightcycle in BRL-CAD using CSGThe movie Tron is an iconic computer graphics film that used CSG primitives for a majority of the movie's 3D virtual world. The film is famous for "lightcycle" vehicles that were allegedly modeled using 57 primitives and/or Boolean operations. For this task, see if you can recreate the masterpiece in BRL-CAD. See this lightcycle discussion thread
|
Quality Assurance
Tasks related to testing and ensuring code is of high quality
Fix single-precision floating point crashBy default, all of BRL-CAD compiles using double-precision floating point arithmetic. We provide a simple typedef, however, that converts almost the entire system over to single-precision floating point. This compilation mode was recently cleaned up and tested, but a bug was found. The problem is reproduced very simply by compiling in single precision mode and running our "rt" ray tracer tool. To compile in single precision, edit the include/bn.h header file and change the fastf_t typedef from double to float. To reproduce the bug, compile BRL-CAD and write this out to a text file named star.view: viewsize 2.500000000e+05; eye_pt 2.102677960e+05 8.455500000e+04 2.934714650e+04; viewrot -6.733560560e-01 6.130643360e-01 4.132114880e-01 0.000000000e+00 5.539599410e-01 4.823888300e-02 8.311441420e-01 0.000000000e+00 4.896120540e-01 7.885590550e-01 -3.720948210e-01 0.000000000e+00 0.000000000e+00 0.000000000e+00 0.000000000e+00 1.000000000e+00 ; start 0; end; Then run rt feeding it that view script as input. This is an example how to run within the gdb debugger: gdb path/to/bin/rt ... (gdb) run -F/dev/X -M .cmake/share/db/star.g all < star.view At this point, rt should crash due to an infinite recursion. A backtrace in the debugger will show lots and lots of calls to rt_shootray() and light_hit(). This task involves investigating and preventing the crash. Provide a patch that fixes the bug. References:
Code:
|
Fix closedbBRL-CAD geometry editor application (mged) has several hundred commands including two very simple commands for opening and closing a geometry database file. While the user rarely ever needs to close the file, as all changes are always immediately saved, it can be of use to scripting applications. However, at some point in the recent past, the closedb command was horked. It's undoubtedly something very simple but we haven't bothered to look due to other priorities. You can fix it. If you run these simple steps within graphical mged, you should see how commands stop working after calling closedb: mged> opendb test.g y mged> make sph sph mged> l sph mged> closedb mged> make sph sph mged> opendb test.g mged> l sph mged> exit Provide a patch that fixes the bug or tell us which SVN revision introduced the bug. Make sure you can reproduce the bug before claiming this task, which presumes you know how to download/install BRL-CAD from a source distribution. Code:
|
Create a utility library (LIBBU) API unit testThere are more than 300 library functions in our core LIBBU library. As a core library used by nearly every one of BRL-CAD's tools, testing those functions for correct behavior is important. This task involves implementing new unit tests for any of LIBBU's source files that do not already have a unit test defined. The test should run all of the public functions and be hooked into our build system. We have lots of existing unit tests to follow as examples. References:
Code:
|
Create Numerics library (LIBBN) API unit testsThere are more than 300 library functions in our core LIBBN library. As a core library used by nearly every one of BRL-CAD's tools, testing those functions for correct behavior is important. This task involves implementing new unit tests for any of LIBBN's source files that do not already have a unit test defined. The test should run all of the public functions and be hooked into our build system. We have lots of existing unit tests to follow as examples. References:
Code:
Note A valid task will constitute writing a basic test for each function in the following libbn/ files.
|
Find, reliably reproduce, and report any bug in ArcherArcher is our new modeling interface and a soon to merge with our long-standing MGED geometry editor. It undoubtedly has bugs. It's your job to find one, but do so in a manner that is so obvious that one of the other devs will be able to instantly reproduce the bug given your specific instructions. Find a way to make archer crash, become unresponsive, or otherwise behave incorrectly. You will have to explore the tool with minimal documentation. This task involves filing a bug report with verifiable and reproducible steps that clearly demonstrate the bug. It can't be a bug already reported or otherwise documented nor can it be merely behavior you don't like. References:
|
Reproduce any 10 unconfirmed open bug reportsBRL-CAD presently has approximately 75 open bug reports of which 50 are unassigned. Read the comments and status to see if the bug has been confirmed/reproduced. This task involves going through those reports and REPRODUCE at least 10 of the ones that have not been confirmed. When you can reproduce the issue being reported, you'll comment on the thread to state as much and attach any data you used to reproduce the crash. References:
|
User Interface
Tasks related to user experience research or user interface design and interaction
Create an ISST screenshot or animationEveryone loves to see screenshots and animations of software in action. We use both in our marketing and outreach. See some of the examples below that we already have. Create an awesome screenshot and/or animation of our 'isst' tool in action. It's an interactive geometry viewer interface. It should be graphically interesting and give some sense of capability. You should import a visually complex and interesting model with LOTS of polygons and detail. Note you may have to go through some or the MGED tutorials (see Docs on our website). References:
|
Categorize all of BRL-CAD's commands into a spreadsheetBRL-CAD is a suite of more than 400 processing tools, image tools, geometry converters, and more. There is an existing spreadsheet that characterizes all of the available commands in terms of inputs, outputs, and options, but there is insufficient characterization of BRL-CAD's commands as to how they logically group and work together. This task involves building up a spreadsheet that lists all of our commands, describing a finite set of command categories, and characterizing all commands into those categories while filling in the spreadsheet with details for each command. References:
|
Design a Cover Photo for Facebook page (and other social networks)BRL-CAD got it's logo changed, and it's website is undergoing a change. So this re-branding of BRL-CAD also requires a good, well designed and attractive cover photo for the BRL-CAD's Facebook page or other Social Media Appearances. It should feature a good tagline telling some killer feature of BRL-CAD, BRL-CAD's new logo and/or some illustration/image regarding the feature highlighted in tagline. It should be consistent with the color scheme of our new website design. New website design
|
Design a banner ad for BRL-CADBRL-CAD is one of the oldest open source communities. This community has a good following, so we want to give a chance to everyone so that they can show their support to the community by adding a banner ad in their website. You have to create a banner ad that can be embedded in the website by copy pasting some simple lines of code (basically an iframe). Such a banner ad can also be used in various sections of our own website. The task requires you to create a CSS3 based animated horizontal and vertical banner add, highlighting some feature of BRL-CAD or making some call to action. This call to action can be joining mailing list, or signing up for community, or link to latest post etc. For Inspiration and tutorial refer
|
Creating Motion Typography video for BRL-CADBRL-CAD has a lot of great features that can be highlighted. A motion typography video highlighting these features would be a wonderful addition to the front page of website. This task requires you to create a motion typography video that will convince user to give BRL-CAD a try, it could be titled something like "x reasons to choose BRL-CAD" or anything similar (give your creative minds a flight). The video should not be more than 2 minutes. For inspiration about what a motion typography, see
|
Create a screen-cast for BRL-CADGetting started with BRL-CAD is sometimes not so smooth. A screen-cast giving a tour of BRL-CAD's GUI and the steps involved in creating the first model will make it easy for users to get started. For this task you need to install BRL-CAD on your computer. Create a very basic model in it and record your screen as you create the model. It should also give a tour of BRL-CAD's workspace. You can choose model of your choice. Keep something very basic and easy for the first time users.
|
Loading Google charts from APIA basic wrapper of GCharts has been implemented a while ago : https://bitbucket.org/suryajith/benchmark/src/a27dd8c05d6819a527650e06a63076599d2e0d66/libs/charting.py?at=default With the google charts improving their API system which wasn't around then, see if the code could be optimized so to get the charts the optimal way. Reference:
|
Design a hall of fame for BRL-CAD developersWe love our developers and want to have a special place in it's website to thank and motivate hard working folks behind BRL-CAD. Your task would be to use an image manipulation software such as GIMP or Photoshop and design a hall of fame page for developers. It should have avatars and names of all the developers. For inspiration you can take a look at http://underscores.me/. You are free to experiment and design anyway you want, just make sure that the color scheme and font-scheme is consistent with the new BRL-CAD web design. Links:
|
When You're Done
For non-code, just send us your file(s). For code changes, you will be expected to provide a patch file. Make sure you read your patch file before submitting it. Make sure your patch file will apply cleanly to an unmodified checkout of BRL-CAD:
svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.edit cd brlcad.edit # make changes svn diff > ~/my.patch # read ~/my.patch file with text editor cd .. svn co https://brlcad.svn.sourceforge.net/svnroot/brlcad/brlcad/trunk brlcad.fresh cd brlcad.fresh patch -p0 < ~/my.patch # submit your patch file to our patches tracker