Monday, September 11, 2006
Unit-Tests for Documentation
LINUX NEWS FROM O'REILLY NETWORK
----------------------------------------
The Latest from http://www.linuxdevcenter.com and http://ONLamp.com
=================================================================
Turbocharge Linux and Solaris Applications with Sun Studio!
Optimizing compilers, application profiler, and high performance libraries
work together, in Sun Studio, to enable developers to boost performance of
their Linux and Solaris applications. (for FREE!)
http://www.oreilly.com/go/dev_sunstudio_lnx91106
=================================================================
Hello, readers of the weekly Linux newsletter.
Your editor had a thought today. There are dozens and perhaps hundreds of
small companies that support and customize software built on free and open
source projects. Those companies serve plenty of customers who aren't
necessarily part of the greater free and open source software communities,
but they benefit greatly from the work of people in those communities.
Is it possible to bring those companies into the communities and, with
them, their customers and partners?
Obviously, your editor wants to widen his company's audience too--but
could this be good for everyone?
It was an interesting thought and seems worth further study.
Once you've made the choice to create good documentation for your project,
you face the embarrassing risk of having bugs, typos, and bad advice in
the documentation. Everyone knows by now that rigorous testing can help
reduce the occurrence of defects in software (even if not everyone does
it). The same principle applies to documentation, with a little bit of
care. Leonard Richardson shares how he and Lucas Carlson verified the
code in the new "Ruby Cookbook" with a technique that works for any sort
of technical writing:
http://www.onlamp.com/pub/a/onlamp/2006/09/07/unit-testing-docs.html
Loops are difficult in SQL. If you need to perform any sort of batch
operation over a list of data with plain SQL, it's likely that you'll need
some sort of procedural wrapper to make everything work correctly. An
alternative is to use embedded functions and stored procedures to perform
your batch operations. David Wheeler shows how to do exactly that in
PostgreSQL and PL/pgSQL:
http://www.oreillynet.com/pub/a/databases/2006/09/07/plpgsql-batch-updates.html
In weblogs this week, Dave Cross summarized his experiences at YAPC::EU,
the grassroots European Perl conference:
http://www.oreillynet.com/onlamp/blog/2006/09/yapceu_2006_day_1.html
http://www.oreillynet.com/onlamp/blog/2006/09/yapceu_2006_day_2.html
http://www.oreillynet.com/onlamp/blog/2006/09/yapceu_2006_day_3.html
Jeremy Jones applauded a satire about Python's enterprisey unsuitability:
http://www.oreillynet.com/onlamp/blog/2006/09/python_not_ready_for_the_enter.html
Andy Oram pleaded for a rational domain-naming system:
http://www.oreillynet.com/onlamp/blog/2006/09/is_it_possible_to_have_a_ratio.html
Your editor found an interesting survey of PHP versions deployed on the internet:
http://www.oreillynet.com/onlamp/blog/2006/09/php_versions_in_the_wild.html
Ann Barcomb summarized the fortnight in Perl 6:
http://www.oreillynet.com/onlamp/blog/2006/09/weekly_perl_6_mailing_list_sum_1.html
http://www.oreillynet.com/onlamp/blog/2006/09/weekly_perl_6_mailing_list_sum_2.html
Anton Chuvakin explained why to look for successes in your logs too:
http://www.oreillynet.com/sysadmin/blog/2006/09/anton_security_tip_of_the_day.html
pat eyler explored a Ruby command-line utility called glark:
http://www.oreillynet.com/ruby/blog/2006/09/spotlight_on_glark.html
Mike Loukides loved starfish's ridiculously easy distributed computing:
http://www.oreillynet.com/ruby/blog/2006/09/ridiculously_easy_distributed.html
Curt Hibbs let slip that Sun has hired the JRuby developers:
http://www.oreillynet.com/ruby/blog/2006/09/sun_is_hiring_jruby_developers.html
Timothy M. O'Brien followed up:
http://www.oreillynet.com/onjava/blog/2006/09/sun_hires_jruby_developers.html
Roland Bouman gave an excellent tutorial about refactoring database cursors:
http://www.oreillynet.com/databases/blog/2006/09/refactoring_mysql_cursors.html
Marc Hedlund and Tim O'Reilly posted on the curious behavior of soldiers
having internet-capable laptops in combat zones:
http://radar.oreilly.com/archives/2006/09/more_on_laptops_at_war.html
Allison Randal reviewed Second Life:
http://radar.oreilly.com/archives/2006/09/the_second_hit_is_free.html
That's (a sample of) everything from this week. Come back in the near
future for more insight from Larry Wall.
States Of An Onion,
- c
chromatic
chromatic@oreilly.com
Technical Editor
O'Reilly Network
================================================================
The First European RailsConf 2006 - September 14-15 London
Learn why Ruby on Rails is taking Europe by Storm! Find out what's new
cool and exciting from more than 25 leading web 2.0 experts, including
David Heinemeier Hansson - creator of Rails, Pragmatic Programmer Dave
Thomas, Rake author Jim Weirich, Why the Lucky Stiff and more!
http://www.oreilly.com/go/railsconf_orn
================================================================
----------------------------------------------------------------
Visit our Sponsored Developer Resource Pages and learn about cool
stuff from our sponsors!
Downloads - Free Training - Webinars - Updates
Driver Agents Driver Updates: http://www.oreilly.com/go/driver_updates
GoToMyPC(R) Remote Access: http://www.oreillynet.com/etel/citrix/
Inside Lightroom: http://digitalmedia.oreilly.com/lightroom/
Rackspace Managed Hosting: http://www.onlamp.com/onlamp/zones/rackspace/
------------------------------------------------------------------
Interested in sponsoring the Linux DevCenter newsletter? Please
email us at advertising@oreilly.com for rate and availability
information. Thank you!
-----------------------------------------------------------------
To change your newsletter subscription options, please visit
http://www.oreillynet.com/cs/nl/home
For assistance, email help@oreillynet.com
O'Reilly Media, Inc.
1005 Gravenstein Highway North
Sebastopol, CA 95472
(707) 827-7000
-----------------------------------------------------------------