Posts

Showing posts from July, 2009

31.07.2009

:*

How to generate user documentation from Perl script?

If you want to generate user documentation from POD in Perl should add at the bottom of script this section - after keyword __END__(this is only example - I use this schema for my documentation): i #!/usr/bin/perl print "hello world!\n"; # end of script # TAGS IN PERLDOC: # *PROGNAME* - replace with program name # *SHORT_DESCRIPTION* - one sentence description __END__ =head1 NAME *PROGNAME* - *SHORT_DESRIPTION*. =head1 SYNOPSIS *PROGNAME* =head1 EXAMPLES *PROGNAME* =head1 REQUIRED ARGUMENTS =head1 OPTIONS =over 4 =item B<-v, --verbose> Be verbose =item B<-d, --debug> Be even more verbose - information specifig for debugging =item B<-h, --help> Display short usage help and exit =back =head1 DESCRIPTION *PROGNAME* was designed for *PURPOSE* =head1 DEPENDENCIES =over 4 =item B<perl 5.6> or newer with standard modules =back =head1 BUGS AND LIMITATIONS You are welcome to send bug reports about *PROGNAME* to my ema…

Alternatives to Nautilus

Image
Today Nautilus was so sluggish that I couldn't stand that any more. I really don't know why this is happening - I've tried searching on Google but no results:(. My CPU usage and disk are getting crazy, when opening directory where is many sub and sub-sub directories especially on USB hard drive. Something is wrong - probably sluggish Nautilus is not due to thumbnails :(. Alternatives to NautilusXfeX File Explorer (Xfe) is an MS-Explorer or Commander like file manager for X. It is based on the popular, but discontinued X Win Commander. In my opinion it's not so nice to use it - looks like software written in mid 90 :( ThunarThis file manager is a component of the XFCE desktop, which is not on the same level as GNOME and KDE but file manager is quite nice.

Pros are: small size, responsiveness, lots of plugins and familiarity for new users.

Cons are: no desktop icons support, bugs in resizing of icons (especially navigation bar), icons are too close to each other (no wa…

Simple Config reader in Perl

Recently I had to develop some config file reading utillity, and here are efects. Config file definition# this is comment ! this also is comment ; and this param : argh param2=argh2 param3 := arghs ; ! # erm? # erm param4 = "test in quotes" # this is invalid param invalid = invalid invalid-2=in-valid param_ok : ok param_test = #this is not commentPerl code (one liner) formating this config fileperl -ne 'm/^([^\$\!;#][A-Z0-9_]+)\s*[=:]+\s*(.*|)/i && printf("%-35s%s\n", $1, $2)'Perl code for reading this file#!/usr/bin/perl # Author: Tomasz Gawęda - blog.0x1fff.com # Date: 2009.07.26 # License: BSD # Description: Simple Perl script for parsing config files # # Dependicies: Perl # Tested on: Perl v5.10.0 use strict; use warnings; # Return value of key in hash if it exists and # it is defined else returns user default (if not set 0) sub getExistsDefine { my ( $hash, $key, $default ) = @_; $default |= 0; return $default if not e…

Darmowe środowisko testowe dla Perla od Microsoftu

Najpierw była zapowiedź, a teraz projekt Microsoftu oferujący darmowe środowisko testowania skryptów Perla dla Windowsa stało się faktem - całość to parę maszyn wirtualnych z głównymi wersjami Windows jak donosi Heise OpenSource. Na maszynach też jest dostępne środowisko Strawberry Perl, tak więc jeśli jesteś deweloperem CPAN - możesz całkowicie za darmo przetestować swoje skrypty pod Windowsem. Jako, że pod Windowsem najczęściej korzystam z dystrybucji Active State ActivePerl to i tak sporo mi to daje - zapewne przesiadka na Strawberry Perl nie będzie żadnym kłopotem (tym bardziej, że jest on dostępny na pendrive). Co to może oznaczać? Hmm, czyżby Microsoft chciał zamienić swój język skryptowy używany w powłoce systemu na Perla? Nie było by to złe rozwiązanie, bo skądinąd wiem że niektóre firmy świadczące usługi serwisowe dla sieci korporacyjnych już obecnie korzystają ze skryptów Perla, które wykonują jakieś tam (*niestety nie wiem jakie*) zadania pod systemami Microsoftu. Czyżby…

Generating ready to print PDF Javadoc file

Some time ago, when writing project from Computer Networks in Java me and my friend want to generate Javadoc in PDF. On Sun tech support is information how to generate Javadoc PDF but it was not really usefull. Reading this article you have to pass few steps and install additional software which is not nice.

After some time I have decided to search other way to do it. I found two applications doclets worth using. What is doclet?Doclet is programs (it's some kind of plugin to Javadoc tool) written in the Java programming language that use the doclet API to specify the content and format of the output of the Javadoc tool. By default, the Javadoc tool uses the "standard" doclet provided by Sun Microsystems to generate API documentation in HTML format. However, user can write own doclets and start generating documentation in custom format for example PDF, PS, TXT.PDFDocletPDFDoclet is doclet build using iText library (for generating PDF). For proper working it requires o…

Making Ubuntu - Jaunty Gnome Environment a little more friendly for those who remember "old Gnome"

Gnome: Ubuntu Home Folder on desktop - where is it? It's not in Gnome Desktop distributed with Ubuntu. I really liked home icon on my desktop but in new version (9.04) of Ubuntu I can't find it. The easiest way to enable it back is, running these commands (gconftool-2): gconftool-2 --type boolean --set /apps/nautilus/desktop/home_icon_visible true gconftool-2 --type string --set /apps/nautilus/desktop/home_icon_name "Home folder" ... and where is the trash icon? It has been also disabled by Ubuntu developers :( - if you want it back just run: gconftool-2 --type boolean --set /apps/nautilus/desktop/trash_icon_visible true For more possible tweaks of Gnome Desktop you can checkout gconf-editor software, or try to navigate of settings tree from command line (gconftool-2 -R /). More interesting tweaks If you're searching for interesting tweaks to your Gnome Desktop you should checkout this entry Gconf - gnome desktop on steroids [EN] or the same in Polish

Aplikacja do pisania bloga

Dla kogo Windows Live Writer Jeżeli jesteś autorem blogai tworzysz swoje notki pod systemem Windows - możesz być zainteresowany projektem Windows Live Writer.
Pełna recenzja tego oprogramowania znajduje się tutaj. Moim zdaniem Oprogramowanie jest użyteczne - jeżeli bym publikował treści na tym blogu spod systemu Microsoft Windows zapewne bym go używał - bo z tego co się przyjrzałem generuje całkiem przyjemny kod XHTML i pozwala na zapisywanie "Wersji roboczych" artykułów lokalnie jeżeli nie jest dostępne połączenie z internetem.
Bardzo podoba mi się fakt, że piszemy "od razu w swoim blogu" - w żywym podglądzie naszego notatnika. Czyżby darmowy produkt Microsoftu który może być użyteczny dla Bloggerów?
Produkt wart zainteresowania w szczególności dla osób rozpoczynających przygodę z tworzeniem materiału do sieci internet - pozwala na szybkie tworzenie i publikowanie treści w internecie metodą WYSWIG. Otwarto źródłowe aplikacje moim zdaniem nie są tak przyjazne …

TP-LINK TD-W8910G - czyli niedrogi sposób na WiFi z ADSL

Image
TP-LINK TD-W8910G Urządzenie mam już ponad rok (a może dwa?) i jestem zadowolony, skonfigurowałem i leży (czasami trzeba zrobić restart, ale to zdarza się rzadko). Router pracuje pod kontrolą Linuxa wg. nmapa (kernel serii 2.6.x) - co jest już samo w sobie ciekawe - i powoduje, że przy odpowiednim kombinowaniu może by się dało tam zainstalować custom firmware - tak jak jest to w niektórych DLinkach. Dane techniczneDostępne porty1x WAN (RJ-11) - neostrada ; 4x LAN (RJ-45) - switchObsługiwane standardyADSL 2+; IEEE 802.11 b/g (WiFi)Szyfrowanie transmisji bezprzewodowejWEP 64/128/152-bit, WPA/WPA-PSK, WPA2/WPA2-PSKZarządzanieWWW, TelnetDodatkowoNAT, Firewall, Filtrowanie IP/MAC, serwer DNS, możliwość skorzystania z freedns, wykręcana antena, QoS (ale nie korzystałem), Chpset: Atheros Opis ten nie jest pełny, ale ukazuje cechy na które ja zwracałem uwagę w momencie kupowania sprzętu. W tym sklepie można poczytać o samym modemie więcej.Co należy zrobić po kupnie? Ustawić parametry lin…