Picasso96 licensing.Version 1.25 is AnyWare (
http://aminet.net/package/driver/video/Picasso96_1.25)
AnyWare, i.e. not commercial or ShareWare. No distribution restrictions.
Version 2.00 is shareware (
http://aminet.net/package/driver/video/Picasso96)
No distribution restrictions as long as the the archive is complete and none of the files within is changed. BBS notes may be added.
Specific permission is
not given to distribute single files from v2.00 archives and integrate them into a separate package.
Picasso96 AMOS Support.Yes I believe we should add it not just for emulation software, but for the hypothetical situation an RTG card is developed for the A1200 expansion slot.
For both AGA and Picasso96 I will initiate a document/data collation project. Will start this after Christmas, giving me a chance to get AMOS Manuals Phase 1 complete and AIAB relaunched.
For coding standards covering such things as prefixes and suffixes I'll need to dig out some industry standards and tweak them to this project and for the languages used:
For this sort of thing:
e.g. Prefixes:
m = Module level
g = Global/Public
Yes I know lots of code will have to be re-factored but this will be necessary to ensure all developers can read each others code.
Also commenting of code is compulsory, as in many cases it will be quicker to re-right the code rather than attempting to decipher the authors algorithms.
This will not be one of those Open-Source projects that the only way to understand the code is for each developer to figure it out for themselves, seen too many projects fail because of this. From the code comments full developer/contributor documented will be written by myself, bruceuncle and/or any other volunteers.
Below I have provided some Module and Function Header guidelines (also provided as an attached text document):
Developers must provide the minimum headers although the full headers would be preferred for documentation purposes. Developers at their own discretion can provide headers at a level between the minimum and full version, albeit in the specified format.
Of particular note is the copyright and license these must be filled in otherwise the code will not be accepted. Please do not use the Public Domain moniker. At a minimum the license should be BSD two clause, no advertisement clause. I have attacked the OSI 'BSD two clause' and 'BSD two clause' templates if you wish to use these.
This will have to be tweaked for the language used whether it be C or assembler:
Module HeaderFull Module Header*-----------------------------------------------------------------------
*-- Module : [Module File Name]
*-- Description : [Primary purpose of the module]
*-- Copyright (C) : [Name of copyright holder]
*-- Author : [Names of Programmers/Authors]
*-- License : [Module License]
*-- Created : [First Release Date]
*-- Last Modified : [Latest Revision Date]
*-- REVISION : [Revision Number]
*-- Notes : [General information/instructions for the programmer]
*-- :
*-- Written for : [Name of target application]
*-- Rev. History :
*-- : [Release Date] -- Original.
*-- : [Release Date][ -- ][Update summary]
*-- : [ -- ][Update summary cont.]
*-- :
*-- Instantiation :
*-- :[Instruction/steps necessary to include/call this module]
*-- :
*-- Dependencies :
*-- :[Required libraries/modules to compile/use this module]
*-- :
*-- Methods :
*-- : [Method Name (args)]
*-- : - [Short Method Description]
*-- :
*-----------------------------------------------------------------------
Example Full Module Header*-----------------------------------------------------------------------
*-- Module : INITIALISEAPP.PRG
*-- Description : Initialises the ExGames database
*-- Copyright (C) : Joe Gilmour
*-- Author : Joe Gilmour
*-- License : BSD
*-- Created : 07/03/2002
*-- Last Modified : 17/04/2002
*-- REVISION : Revision: 0.04
*-- Notes :
*-- : Contains routines to:
*-- : Initialise all forms, array and objects on application startup.
*-- :
*-- :
*-- Written for : dBASE for Windows 5.7
*-- Rev. History :
*-- : 07/03/2002 -- Original.
*-- : 01/04/2002 -- Added arrays for initialising game review data.
*-- : 04/04/2002 -- Added arrays for initialising collectors notes data.
*-- : 17/04/2002 -- Optimized code, Used "NEW Array (rows, cols)" instead of
*-- : using the grow method to set the size of arrays.
*-- :
*-- Instantiation :
*-- : set procedure to initialiseapp.prg additive
*-- :
*-- Dependencies :
*-- : center.prg
*-- :
*-- Methods :
*-- : Procedure FindGameName(SearchMethod, SearchGName)
*-- : - Check for a games existance
*-- :
*-----------------------------------------------------------------------
Minimum Module Header*-----------------------------------------------------------------------
*-- Module : [Module File Name]
*-- Description : [Primary purpose of the module]
*-- Copyright (C) : [Name of copyright holder]
*-- Author : [Programmer/Authors name]
*-- License : [Module License]
*-- Created : [First Release Date]
*-- Last Modified : [Latest Revision Date]
*-- REVISION : [Revision Number]
*-----------------------------------------------------------------------
Example Minimum Module Header*-----------------------------------------------------------------------
*-- Module : INITIALISEAPP.PRG
*-- Description : Initialises the ExGames database
*-- Copyright (C) : Joe Gilmour
*-- Author : Joe Gilmour
*-- License : BSD
*-- Created : 07/03/2002
*-- Last Modified : 17/04/2002
*-- REVISION : Revision: 0.04
*-----------------------------------------------------------------------
Function/Procedure HeaderFull Function/Procedure Header*-----------------------------------------------------------------------
*-- Function : [Function Name]
*-- Description : [Primary purpose of the module]
*-- Copyright (C) : [Name of copyright holder]
*-- Author : [Names of Programmers/Authors]
*-- License : [Module License]
*-- Created : [First Release Date]
*-- Last Modified : [Latest Revision Date]
*-- REVISION : [Revision Number]
*-- Notes :
*-- : [General information/instructions for the programmer]
*-- :
*-- Written for : [Name of target application]
*-- Rev. History :
*-- : [Release Date] -- Original.
*-- : [Release Date][ -- ][Update summary]
*-- : [ -- ][Update summary cont.]
*-- :
*-- :
*-- Calls :
*-- : [Other modules/functions this function calls]
*-- :
*-- Called by :
*-- : [Other modules/functions this function is called by]
*-- :
*-- Usage :
*-- : [Instruction/steps necessary to include/call this function]
*-- :
*-- Returns :
*-- : [Returned variable and type]
*-- : - [Short description of returned variable]
*-- :
*-- Parameters :
*-- : [Parameters/Arguments used by this function]
*-- : - [Short description of parameter/argument]
*-- :
*-----------------------------------------------------------------------
Example Full Function/Procedure HeaderProcedure UpdateGameSet(GameIDNum)
*-----------------------------------------------------------------------
*-- Function : UpdateGameSet
*-- Description : Saves an updated game entry to the database
*-- Copyright (C) : Joe Gilmour
*-- Author : Joe Gilmour
*-- License : BSD
*-- Created : 10/03/2002
*-- Last Modified : 05/04/2002
*-- REVISION : Revision: 5
*-- Notes :
*-- : Saves an updated game entry to the database tables from data stored in the arrays.
*-- :
*-- Written for : dBASE for Windows 5.7
*-- Rev. History :
*-- : 11/03/2002 -- Original
*-- : 12/03/2002 -- Added arrays for initialising admin data.
*-- : 01/04/2002 -- Added arrays for updating game review data.
*-- : 05/04/2002 -- Added arrays & Code to update collectors notes data.
*-- : 23/04/2002 -- Split code into two procedures one for initialising the arrays and
*-- : one for saving the array values to the database
*-- :
*-- Calls :
*-- : None
*-- :
*-- Called by :
*-- : Any
*-- :
*-- Usage :
*-- : UpdateGameSet(GameIDNum)
*-- :
*-- Returns :
*-- : None
*-- :
*-- Parameters :
*-- : GameIDNum
*-- : - index number of the game to update
*-- :
*-----------------------------------------------------------------------
Minimum Function/Procedure Header*-----------------------------------------------------------------------
*-- Function : [Module File Name]
*-- Description : [Primary purpose of the module]
*-- Copyright (C) : [Name of copyright holder]
*-- Author : [Programmer/Authors name]
*-- Created : [First Release Date]
*-- Last Modified : [Latest Revision Date]
*-- REVISION : [Revision Number]
*-----------------------------------------------------------------------
Example Minimum Function/Procedure Header*-----------------------------------------------------------------------
*-- Function : UpdateGameSet
*-- Description : Saves an updated game entry to the database
*-- Copyright (C) : Joe Gilmour
*-- Author : Joe Gilmour
*-- Created : 07/03/2002
*-- Last Modified : 17/04/2002
*-- REVISION : Revision: 0.04
*-----------------------------------------------------------------------