NetScript

A script to compile automatically NetSurf for AmigaOS3 (Cross-compilation Windows using Cygwin - AmigaOS3)

Important Information

To use NetScript, you need Cygwin installed into your computer. A tutorial to install cygwin is available below.

NetScript includes the choice to compile NetSurf with or without DukTape, as there are some issues with it.
You can also choose to keep the files needed to compile NetSurf, to dig in the code.

Since the 20160808-1 version, it is possible to execute NetScript in QUICK MODE.
This mode only compiles the netsurf folder (useful for those who often modify or debug it).
You need to use NetScript normally at least once to be able to use the QUICK MODE.
This version is also more dev-friendly : as a developer, you can compile NetSurf easily with your files modification.

If you only need to get NetSurf already compiled for AmigaOS3, you can download the NetSurf_XXX_AmigaOS3_CompilationDate.tar only. This version doesn't contain DukTape and might be obsolete as it isn't updated every day.

How to use NetScript ?

Here is the tutorial to make it work :

1. Download the ZIP archive from the branch you want by selecting the branch,
   then clicking the "Clone or download" button, then "Download ZIP".
   You can download the files from the master branch by clicking this link.
2. Open Cygwin as an Administrator (right click on the Cygwin shortcut, then select "Open as an Administrator").
   This will create automatically your personal directory. ;
3. Extract the ZIP archive into a folder located in your personal directory ;
   If you don`t change the cygwin install directory, it`s probably C:\cygwin\home\*Name of your windows session*
4. On your Cygwin window, Move to the directory containing the files (via the cd command) ;
5. Use this command between the quotation marks to start NetScript : "./NetScript.sh".
   If you want to use the QUICK MODE, use this command "./NetScript.sh -q" or this one "./NetScript.sh --quick".
   Please see the "Important Information" part before

What does NetScript contains ?

NetScript is composed of :

• NetScript.sh, the script to launch, which creates the LOG file, useful if you reach the bad ending (since the 20160808-1 version) ;
• NS.sh, the script which downloads, installs and compiles NetSurf (since the 20160808-1 version) ;
• updateFiles.sh, the script used to modify some files during the compilation to fit in Cygwin ;
• the updateFile folder, which goes with scriptFilesUpdate.sh and contains every file modification script ;

How to install Cygwin ?

Here is the tutorial to install cygwin correctly to be sure NetScript works :

1. Download cygwin via the official website (32 or 64 bits version, I advise the 32 one) ;
2. Execute the setup file you just downloaded ;
3. Click "Next" ;
4. Select "Install from Internet", then click "Next" ;
5. You can let the default Root Directory and the selected "Install For : All Users" as is (or change it if you need). Click "Next" ;
6. You can let the default Local Package Directory as is (or change it if you need). Click "Next" ;
7. Select "Direct connection", then click "Next" ;
8. Select the available download site you want (for example, "http://cygwin.mirror.constant.com"), then click "Next". Cygwin downloads some packages... ;
9. You can let the "Default" installation on every row as is (or change it if you need). Click "Next" ;
10. If a "Resolving Dependencies" window appears, verify the "Select Required Packages" box is checked, then click "Next". The cygwin setup should be launched and won't last too long...
11. At the end of the installation, you can check the "Create icon on Desktop" and/or the "Add icon to Start Menu" boxes if you want, finally click "Finish". Cygwin should be installed properly !

Thank you for using NetScript !
Please give credits when you use NetScript.

*** Readme Version : 20160814-1 ***