Help:Contents/Development Setup

From Varamozhi

Contents 1 Install Cygwin 2 Install ActivePerl 3 Install Perl/Tk 4 Install NSIS 5 Start Cygwin 6 Checkout 6.1 For developers 6.1.1 More Info 7 Shell Access 8 Compiling 9 Starting the editor 10 Release process

[edit] Install Cygwin

Execute Cygwin setup.exe. Select all packages for installation. By clicking Default across all packages.

[edit] Install ActivePerl

Get ActivePerl latest free version.

[edit] Install Perl/Tk

• In cmd console run ppm
• Add the CPAN repository http://www.bribes.org/perl/ppm
• Search for Tk, PAR::packer and add latest versions and install

[edit] Install NSIS

Required only for creating the installation package.

After installing NSIS, install the FontName plugin.

[edit] Start Cygwin

Run C:\cygwin\usr\X11R6\bin\startxwin.bat. It may be a good idea to keep a shortcut to this file in your desktop or quick launch.

[edit] Checkout

In cygwin, for anonymous access:

cvs -z3 -d:pserver:anonymous@varamozhi.cvs.sourceforge.net:/cvsroot/varamozhi checkout varamozhi

[edit] For developers

Create an ssh key:

ssh-keygen -t dsa -C "USERNAME@shell.sf.net"

Copy paste contents of ~/.ssh/id_dsa.pub in https://sourceforge.net/account/editsshkeys.php Sourceforge says there will 10 minute delay in updating these keys.

To checkout:

export CVS_RSH=ssh
cvs -z3 -d:ext:USERNAME@varamozhi.cvs.sourceforge.net:/cvsroot/varamozhi checkout varamozhi

Add appropriate aliases or exports to your profile files for easy access in the future.

[edit] More Info

• Key generation
• CVS access

[edit] Shell Access

USERNAME@varamozhi.sf.net:/home/groups/v/va/varamozhi
web: /home/groups/v/va/varamozhi/htdocs/

[edit] Compiling

For compiling basic set:

cd ~/varamozhi/varamozhi
make FONT=mathrubhumi
make FONT=unicode

For compiling for all fonts:

cd ~/varamozhi
make <version number> # ex: version number = 1.07.01

[edit] Starting the editor

In cmd window, do:

cd c:\cygwin\home\<username> (or your cygwin home thru windows)
cd varamozhi\varamozhi
perl gui\editor.pl -t

[edit] Release process

In cygwin:

 cd varamozhi
 make 1.1.15 # (example) next version number

In cmd console:

 cd C:\cygwin\home\<username>\varamozhi\varamozhi
 pp --icon gui\varamozhi-icon7.ico -z 0 -o gui\editor.exe -v gui\editor.pl

In windows, change version number in varamozhi/installer/Varamozhi Complete Installer.nsi

Right click on varamozhi/installer/Varamozhi Complete Installer.nsi and compile the script to create the installer. VaramozhiInstaller<version>.exe will be created in varamozhi/installer.

Testing: in a test PC; remove old installation; delete varamozhi install dir; install; test using words.mozhi file

In cygwin:

 cd ~/varamozhi
 make install

Go to https://sourceforge.net/project/admin/qrs.php?package_id=&group_id=5819 for quick release

For executable:

    package id: editor executable
    release name: 1.01.15 (example)
    file name: VaramozhiEditorSetup<version>.exe (select from local dir)
    file type: .exe (32 bit windows)
    processor type: i386
    change log: description of the change

For source:

    package id: editor source
    release name: 1.01.15 (example)
    file name: varamozhi_editor_src<version>.tgz (select from local dir)
    file type: source .gz
    processor type: platform independant
    change log: description of the change