home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
nosac106.zip
/
nosac.hlp
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
2001-12-15
|
158KB
|
2,354 lines
ΓòÉΓòÉΓòÉ 1. OS/2 Netlabs Open Source Archive Client ΓòÉΓòÉΓòÉ
in association with
present the
OS/2 Netlabs Open Source Archive Client
Select one of the following topics:
What is it all about ?
Prerequisites
Copyright & Co.
Installation
Usage
How can I ... ?
Limitations
Revision history
Trademarks
Credits
ΓòÉΓòÉΓòÉ 1.1. What is it all about ? ΓòÉΓòÉΓòÉ
Select one of the following topics:
Overview
Open Source
OS/2 Netlabs
Team OS/2 Germany
Concurrent Versions System (CVS)
Info-Zip
EMX Runtime
ΓòÉΓòÉΓòÉ 1.1.1. Overview ΓòÉΓòÉΓòÉ
OS/2 Netlabs Open Source Archive Client
Are you an OS/2 developer or want to be one ? Do you search for sample
sourcecode or do you have a really good idea for an OS/2 program ? Would you
like to have a look at some of the best OS/2 apps or utilities around ?
Then come to the OS/2 Netlabs and see, what OS/2 projects are currently hosted
here. More, Netlabs hosts source archives for several Open Source Projects in
the OS/2 Netlabs Open Source Archive, which can be freely accessed.
The OS/2 Netlabs Open Source Archive Client package being presented to you by
OS/2 Netlabs in association with Team OS/2 Germany shall help you to access
these source archives. With this you can download those sources and update them
whenever you like, as the OS/2 Netlabs Open Source Archive represents the
current stage of development at every time.
This package is meant to ease the access to the OS/2 Netlabs Open Source
Archive, as you need the Concurrent Versions System (CVS) for to access the
source archive, and this system is somewhat complex for beginners. The OS/2
Netlabs Open Source Archive Client will both help you with the installation and
usage of CVS and does not force you to learn dozen of commands with parameters
for usage on the command line before being able to see the source. Nevertheless
this package can aid only to a certain extend, so that for some more complex
operations it is still required to know CVS very well and to use the command
line. But for the few things, that a beginner requires, and even for most of
the operations, that a developer will need for modifications in the archive
(requiring write permissions, of course), the OS/2 Netlabs Open Source Archive
Client folder and its objects will be sufficient.
ΓòÉΓòÉΓòÉ 1.1.2. Open Source ΓòÉΓòÉΓòÉ
If you want to know
what Open Source exactly is
because of what reasons it would make sense to make your own software
Open Source
would like to know why Open Source makes sense for everybody, no matter
if one is a hacker, business-man or a customer
visit the following pages:
The Open Source Page
by the Open Source Initiative
The Cathedral and the Bazaar
by Eric S. Raymond
The following are publications of OS/2 e-Zine!:
A dream of Open Source
by Christopher B. Wright
The Bazaar and the Other Bazaar
by Christopher B. Wright
GNU's Not Linux
by Christopher B. Wright
Why OpenSource ?
by Ulrich MФller
The following is a publication of The Electronical Developer Magazine for
OS/2:
A Warped RCS/CVS HowTo
by Henry Sobotka
See also the current issues of
OS/2 e-Zine!
The Electronical Developer Magazine for OS/2
ΓòÉΓòÉΓòÉ 1.1.3. OS/2 Netlabs ΓòÉΓòÉΓòÉ
OS/2 Netlabs
What is the goal behind OS/2 Netlabs ?
The answer is simple: New programs for OS/2.
Possibly every OS/2-user was at least mad once about having to change to
another Operating System, only because there was no alternative for a program
under OS/2.
OS/2 Netlabs will definitely put an end to these times. The whole OS/2
programming power can gather on the OS/2 Netlabs web pages in order to create
freeware-programs in the style of the GNU-project under Linux and OS/2. Every
user may download these programs and copy freely.
Every OS/2-user can make his contribution to OS/2 Netlabs, whether it is as a
programmer, a designer, a supplier of ideas or just as a user. Netlabs founds
on the user, every user should be able to give his visions of software a place
to grow.
The OS/2 Netlabs Project is a logical consequence coming out of the growing
possibilities of the internet. OS/2-users are in most cases experienced
programmers. If now all their potential is brought together and used as a
whole, a lot of useful and creative programs can result from it. Netlabs is a
contribution to a sound OS/2-future with a lot of good programs which do not
cost a fortune, but can keep up with any other software available.
Visit the homepage of
the OS/2 Netlabs
the OS/2 Netlabs Open Source Archive
ΓòÉΓòÉΓòÉ 1.1.4. Team OS/2 Germany ΓòÉΓòÉΓòÉ
Team OS/2 Germany
Similar to the Team OS/2 in the USA and to other OS/2 user groups, also in
Germany OS/2 team members support and promote OS/2 wherever possible on a
private basis.
After having grown to somewhat over 1000 members in 1996, at some regions,
local Team OS/2 groups as registered societies have been founded in order to
increase the efficiency of administration and the organisation of Team OS/2
events. Another intention was to become more independent from support from IBM
for Team OS/2, which has been more and more going down over the years anyway.
These local societies have then organized themselves in an umbrella
organization named Team OS/2 Deutschland e.V., where common needs of local
societies can be satisfied better.
Visit the homepage of
Team OS/2 Deutschland e.V and its member associations
ΓòÉΓòÉΓòÉ 1.1.5. Concurrent Versions System (CVS) ΓòÉΓòÉΓòÉ
See the following links in order to learn more about the Concurrent Versions
System (CVS):
Cyclic Software, the home of CVS
CVS Bubbles with links to documentation
You can download CVS for OS/2 from:
The Hobbes OS/2 Archive
or search the nearest FTP server near you via
FTP Search
Note:
CVS requires the EMX Runtime.
See also
- How can I solve the 'Too many open files' problem ?
ΓòÉΓòÉΓòÉ 1.1.6. Info-Zip ΓòÉΓòÉΓòÉ
The installation program of the OS/2 Netlabs Open Source Archive Client uses
the UnZip program of Info-Zip to install the Concurrent Versions System (CVS)
on your system, if it is not already installed.
Even though you might need only the UnZip program to unpack the CVS zip file
during installation, but only if CVS is not already installed, having both the
UnZip and Zip program is a must for every OS/2 installation.
Note:
The source of Info-Zip is freely available. On the Info-Zip homepage
follow the links to the source on the download pages.
The filename scheme for the executable packages and source packages
differ a littlebit from UnZip to Zip unzip. This is a littlebit
confusing, so the scheme is listed here for the current versions Zip
V2.20 and UnZip V5.40 as an example:
zip22x1.zip Zip 2.2, OS/2 16-bit exes (no encryption)
zip22x2.zip Zip 2.2, OS/2 32-bit exes (no encryption)
zip22.zip Zip 2.2, source code
unz540d2.zip UnZip 5.40, OS/2 DLL (32-bit, C and REXX)
unz540x1.exe UnZip 5.40, OS/2 self-extr. exes (16-bit)
unz540x2.exe UnZip 5.40, OS/2 self-extr. exes (32-bit)
unzip540.zip UnZip 5.40, source code
You can download the zip and unzip program of Info-Zip for OS/2 from:
The Info-ZIP homepage
Follow both the links to UnZip and Zip and download the latest version
for OS/2.
ΓòÉΓòÉΓòÉ 1.1.7. EMX Runtime ΓòÉΓòÉΓòÉ
EMX is an environment for creating 32-bit programs for OS/2 (and DOS).
Developers can use the GNU C compiler to compile programs for emx. The main
design goal of emx is to simplify porting Unix software to OS/2 and DOS.
This has been done with the Concurrent Versions System (CVS), which is a widely
used Unix software.
As CVS is being used by the OS/2 Netlabs Open Source Archive Client, the
runtime of the EMX package is required.
You can download the EMX runtime for OS/2 from:
The Hobbes OS/2 Archive
Download the file emxrt.zip from the subdirectory with the highest revision
number.
See also
How can I solve the 'Too many open files' problem ?
ΓòÉΓòÉΓòÉ 1.2. Prerequisites ΓòÉΓòÉΓòÉ
The following prerequisites apply to the current version of OS/2 Netlabs Open
Source Archive Client:
The OS/2 Netlabs Open Source Archive Client runs under OS/2 WARP Version
3 or later.
Also required is the OS/2 version of the Concurrent Versions System (CVS)
for to access the OS/2 Netlabs Open Source Archive.
CVS in turn requires the EMX Runtime.
If CVS is not already installed on your system, the UnZip program of
Info-ZIP is required.
For downloading sources from the OS/2 Netlabs Open Source Archive, also a
working internet connection is required.
ΓòÉΓòÉΓòÉ 1.3. Copyright & Co. ΓòÉΓòÉΓòÉ
Select one of the following topics:
Copyright
freeware license
Disclaimer
The author
ΓòÉΓòÉΓòÉ 1.3.1. Copyright ΓòÉΓòÉΓòÉ
OS/2 Netlabs Open Source Archive Client
was written by Christian Langanke, 1999, 2001.
All rights reserved.
You are welcome to send me your comments/suggestions via internet e-mail.
Send your e-mail to C.Langanke@TeamOS2.DE
Visit also the homepage of
the OS/2 Netlabs Open Source Archive
the author Christian Langanke
the OS/2 Netlabs
Team OS/2 Germany and its member associations
ΓòÉΓòÉΓòÉ 1.3.2. freeware license ΓòÉΓòÉΓòÉ
This software package is freeware. It can be used wherever you use OS/2 WARP
Version 3 or later.
You are allowed to freely use and distribute the OS/2 Netlabs Open Source
Archive Client as long as
OS/2 Netlabs Open Source Archive Client or its components are not sold as
a part of another program package;
no fee is charged for the program other than for cost of media;
the complete package is distributed unmodified;
ΓòÉΓòÉΓòÉ 1.3.3. Disclaimer ΓòÉΓòÉΓòÉ
Since this program is free, it is supplied with no warranty, either expressed
or implied.
I disclaim all warranties for any damages, including, but not limited to,
incidental or consequential damage caused directly or indirectly by this
software.
All software is supplied AS IS. You may use the OS/2 Netlabs Open Source
Archive Client package only at your own risk.
The OS/2 Netlabs Open Source Archive Client must not be used in states that do
not allow the above limitation of liability.
ΓòÉΓòÉΓòÉ 1.3.4. The author ΓòÉΓòÉΓòÉ
This program is written by Christian Langanke.
You can contact the author via internet e-mail.
Send your email to C.Langanke@TeamOS2.DE
Visit also the homepage of
the OS/2 Netlabs Open Source Archive Client
the author Christian Langanke
the OS/2 Netlabs
Team OS/2 Germany and its member associations
ΓòÉΓòÉΓòÉ 1.4. Installation ΓòÉΓòÉΓòÉ
Select one of the following topics:
Copy files
installation program
The OS/2 Netlabs Open Source Archive Client folder
- Current OS/2 Netlabs Open Source Archives
- OS/2 Netlabs Open Source Archive Connections
- OS/2 Netlabs Open Source Archive Information
- Update the Open Source Archive list from OS/2 Netlabs
- View the OS/2 Netlabs Open Source Archive list
- Update Current Archive folder
- Edit CVS configuration
Archive folder
- Login
- Logout
- Checkout file
- Fix Snapshot
- View file log
- Query file status
- Add new file
- Update local files
- Merge to local files
- Commit file changes
- Tag file
- Generate Change Report
- Remove file
- View modules
- OS/2 Window
ΓòÉΓòÉΓòÉ 1.4.1. Copy files ΓòÉΓòÉΓòÉ
If you received the OS/2 Netlabs Open Source Archive Client package as a ZIP
file, create a directory for the files on your harddisk and unzip all files
from the ZIP file into it.
Make sure that the directory structure stored within the ZIP file is preserved.
Then execute the installation program.
ΓòÉΓòÉΓòÉ 1.4.2. installation program ΓòÉΓòÉΓòÉ
To setup the OS/2 Netlabs Open Source Archive Client and create a
WorkplaceShell folder with precustomized program objects in it, execute the
following steps:
1. open an OS/2 Window
2. change into the directory, where the files of the OS/2 Netlabs Open
Source Archive Client package reside
3. run the command
install
If the required Concurrent Versions System (CVS) is not included in the PATH
or is not already installed on your system, you can either
enter the Directory of CVS installation later (see below).
let the installation program program install CVS or
If you want to let CVS be installed automatically, you need to
copy the zip file with the current CVS version for OS/2 into the same
directory with install.cmd, where the zip file must be named cvs???.zip
the UnZip program of Info-ZIP is required.
Note:
If CVS is installed here by the installation program, the CONFIG.SYS is
NOT modified in order to extend the PATH by the CVS bin directory,
because this is not required by the OS/2 Netlabs Open Source Archive
Client. Instead, if you perform any CVS operation via the The OS/2
Netlabs Open Source Archive Client folder or open an archive OS/2 Window,
the path is extended to the CVS bin directory for these sessions only.
The installation program then prompts for several values.
You can accept the default values being displayed in brackets by just hitting
Enter. Values marked as optional may be empty. You also can interrupt the
installation program by hitting Ctrl-Break and Enter. You also can rerun the
installation program at any time in order to modify any of these values.
These are the values, that you are prompted for:
Netlabs Open Source Archive Server
The server hosting the OS/2 Netlabs Open Source Archive. If you have
other NOSA-like archive servers beside the one from OS/2 Netlabs, you can
specify multiple hostnames separated by commas.
root directory for working directories on your computer
The directory, where all working directories, that you use with the OS/2
Netlabs Open Source Archive Client, are being created.
CVS home directory
The (empty) directory, where CVS settings are stored
Init Command for project windows (optional)
any command that you want to be executed before OS/2 Netlabs Open Source
Archive Client executes any CVS operation. This is especially useful when
you frequently use archive OS/2 Windows, for which you may need to setup
a different environment.
Leave that field empty, if you do not need any init command.
CVS User Id
your user id, that you want to use with a CVS archive on the OS/2 Netlabs
Open Source Archive server.
Note:
If you need only readonly access to the OS/2 Netlabs Open Source
Archive, specify guest as your userid and later specify readonly as
your password when logging into the server.
If you take part in any of the projects being hosted by the OS/2
Netlabs Open Source Archive, you have to specify the user id, that
has been setup at OS/2 Netlabs for your login.
If the environment variable %USER% is set, this value is offered as
default.
In an archive OS/2 Window the environment variable %USER% will be
set up with the user id, that you specify here. Keep that in mind,
if you have to use different values for %USER% within the OS/2
Netlabs Open Source Archive Client and elswewhere.
pager executable
the executable, that should page long CVS outputs. Default is more, which
of course has the disadvantage, that you can only go forward within the
output, but cannot page back, like less or certain versions of list.
Directory of CVS installation
This prompt only appears, if the CVS executables are not reachable by
your PATH statement in CONFIG.SYS. Then you can specify the installation
directory of CVS and the OS/2 Netlabs Open Source Archive Client will
extend the PATH before performing any CVS operation.
After that the installation program creates the OS/2 Netlabs Open Source
Archive Client Workplace Shell folder with several objects in it.
ΓòÉΓòÉΓòÉ 1.4.3. The OS/2 Netlabs Open Source Archive Client folder ΓòÉΓòÉΓòÉ
To (re)create the OS/2 Netlabs Open Source Archive Client folder with
precustomized program objects in it, execute the following steps:
1. open an OS/2 Window
2. change into the directory, where the files of the OS/2 Netlabs Open
Source Archive Client package reside
3. run the command
cvswps
The following Workplace Shell objects are created within the OS/2 Netlabs Open
Source Archive Client folder:
Current OS/2 Netlabs Open Source Archives
OS/2 Netlabs Open Source Archive Connections
OS/2 Netlabs Open Source Archive Information
Update the Open Source Archive list from OS/2 Netlabs
View the OS/2 Netlabs Open Source Archive list
Update Current Archive folder
Edit CVS configuration
In the folder named Current OS/2 Netlabs Open Source Archives for each CVS
archive on the OS/2 Netlabs Open Source Archive server a separate Archive
folder is created.
Note:
If you want to change the location of the files of the OS/2 Netlabs Open
Source Archive Client package, move the directory, where the files
reside, to the new location and rerun the installation program to update
the objects.
ΓòÉΓòÉΓòÉ 1.4.3.1. Current OS/2 Netlabs Open Source Archives ΓòÉΓòÉΓòÉ
This folder within the OS/2 Netlabs Open Source Archive Client folder contains
one subfolder for each CVS archive on the OS/2 Netlabs Open Source Archive
server.
See also
Archive folder
The archive list file
View the archive list
Update the archive list file
Update the Current Archive Folder
ΓòÉΓòÉΓòÉ 1.4.3.2. OS/2 Netlabs Open Source Archive Connections ΓòÉΓòÉΓòÉ
This folder within the OS/2 Netlabs Open Source Archive Client folder contains
Universal Resource Locator (URL) objects related to the OS/2 Netlabs Open
Source Archive.
Note:
Before you open one of the URL objects to display the World Wide Web
pages within your internet browser, that these URLs point to, make sure,
that you have an active internet connection.
Shadows of all objects within this folder are also created in the
Connections folder of OS/2.
ΓòÉΓòÉΓòÉ 1.4.3.3. OS/2 Netlabs Open Source Archive Information ΓòÉΓòÉΓòÉ
This folder within the OS/2 Netlabs Open Source Archive Client folder contains
documentation about the OS/2 Netlabs Open Source Archive Client and, if
installed on your system, objects for the the online documentation about the
Concurrent Versions System (CVS).
Note:
Shadows of all objects within this folder are also created in the
Information folder of OS/2.
ΓòÉΓòÉΓòÉ 1.4.3.4. Update the Open Source Archive list from OS/2 Netlabs ΓòÉΓòÉΓòÉ
This object within the OS/2 Netlabs Open Source Archive Client folder updates
the OS/2 Netlabs Open Source Archive list file via FTP from OS/2 Netlabs.
You need to have an active internet connection for being able to update this
file.
See also
The archive list file
View the archive list
Update the archive list file
Update the Current Archive Folder
ΓòÉΓòÉΓòÉ 1.4.3.5. View the OS/2 Netlabs Open Source Archive list ΓòÉΓòÉΓòÉ
This object within the OS/2 Netlabs Open Source Archive Client folder lets you
view the contents of the OS/2 Netlabs Open Source Archive list file.
See also
The archive list file
View the archive list
Update the archive list file
Update the Current Archive Folder
ΓòÉΓòÉΓòÉ 1.4.3.6. Update Current Archive folder ΓòÉΓòÉΓòÉ
This object within the OS/2 Netlabs Open Source Archive Client folder updates
the folder named "Current OS/2 Netlabs Open Source Archives".
See also
The archive list file
View the archive list
Update the archive list file
Update the Current Archive Folder
ΓòÉΓòÉΓòÉ 1.4.3.7. Edit CVS configuration ΓòÉΓòÉΓòÉ
This object within the OS/2 Netlabs Open Source Archive Client folder edits the
file %home%\.cvsrc, which contains global CVS options used by the OS/2 Netlabs
Open Source Archive Client.
See the CVS reference sections for more information:
Default options and the ~/.cvsrc file
ΓòÉΓòÉΓòÉ 1.4.4. Archive folder ΓòÉΓòÉΓòÉ
In the folder named Current OS/2 Netlabs Open Source Archives for each CVS
archive on the OS/2 Netlabs Open Source Archive server a separate Archive
folder is created with the following Workplace Shell objects inside:
Login
Logout
Checkout file
Fix Snapshot
View file log
Query file status
Add new file
Update local files
Merge to local files
Commit file changes
Tag file
Generate Change Report
Remove file
View modules
OS/2 Window
More, a shadow to the working directory of the archive on your computer is
created.
See also
Using an archive folder
ΓòÉΓòÉΓòÉ 1.4.4.1. Login ΓòÉΓòÉΓòÉ
This object within an archive folder logs you into a CVS archive on the OS/2
Netlabs Open Source Archive server.
Note:
Executing this icon has the same effect like executing the command
cvs login
within an archive OS/2 Window.
See also
Logging into the CVS server
ΓòÉΓòÉΓòÉ 1.4.4.2. Logout ΓòÉΓòÉΓòÉ
This object within an archive folder logs you out of a CVS archive you
previously logged into.
Note:
Executing this icon has the same effect like executing the command
cvs logout
within an archive OS/2 Window.
See also
Logging out of the CVS server
ΓòÉΓòÉΓòÉ 1.4.4.3. Checkout file ΓòÉΓòÉΓòÉ
This object within an archive folder checks out a file of CVS archive on the
OS/2 Netlabs Open Source Archive server.
Note:
Executing this icon has the same effect like executing the command
cvs checkout <files>
within an archive OS/2 Window.
See also
Checkout source files
ΓòÉΓòÉΓòÉ 1.4.4.4. Fix Snapshot ΓòÉΓòÉΓòÉ
This object within an archive folder fixes a previously unpacked snapshot of
the CVS archive.
Note:
Executing this icon has the same effect like executing the command
cvsenv $FIX
within an archive OS/2 Window.
See also
Using CVS snapshots
ΓòÉΓòÉΓòÉ 1.4.4.5. View file log ΓòÉΓòÉΓòÉ
This object within an archive folder shows the CVS log in an archive.
Note:
Executing this icon has the same effect like executing the command
cvs log <files>
within an archive OS/2 Window.
See also
view CVS log of source files
ΓòÉΓòÉΓòÉ 1.4.4.6. Query file status ΓòÉΓòÉΓòÉ
This object within an archive folder shows the status of a local file of a CVS
archive.
Note:
Executing this icon has the same effect like executing the command
cvs status <files>
within an archive OS/2 Window.
See also
view CVS status of source files
ΓòÉΓòÉΓòÉ 1.4.4.7. Add new file ΓòÉΓòÉΓòÉ
This object adds a new file or directory to a CVS archive on the OS/2 Netlabs
Open Source Archive server.
Note:
Executing this icon has the same effect like executing the command
cvs add <files|directories>
within an archive OS/2 Window.
See also
add new source files
ΓòÉΓòÉΓòÉ 1.4.4.8. Update local files ΓòÉΓòÉΓòÉ
This object updates local files with changes being made by others in a CVS
archive on the OS/2 Netlabs Open Source Archive server since you last. checked
out or updated the file.
Note:
Executing this icon has the same effect like executing the command
cvs update <files>
within an archive OS/2 Window.
See also
Update source files
ΓòÉΓòÉΓòÉ 1.4.4.9. Merge to local files ΓòÉΓòÉΓòÉ
This object merges changes being made by others in a CVS archive on the OS/2
Netlabs Open Source Archive server to local modified files.
Note:
Executing this icon has the same effect like executing the command
cvs update <files>
within an archive OS/2 Window.
Althouth there exist two icons for updating a local file and merging to a
local file within the OS/2 Netlabs Open Source Archive Client folder,
they actually execute the same CVS command, namely update.
See also
merge local files
ΓòÉΓòÉΓòÉ 1.4.4.10. Commit file changes ΓòÉΓòÉΓòÉ
This object commits your changes to the archive CVS archive on the OS/2 Netlabs
Open Source Archive server.
Note:
Executing this icon has the same effect like executing the command
cvs commit <files>
within an archive OS/2 Window.
See also
commit changes to the CVS server
ΓòÉΓòÉΓòÉ 1.4.4.11. Tag file ΓòÉΓòÉΓòÉ
This object adds, moves or removes tags for files in a CVS archive on the OS/2
Netlabs Open Source Archive server.
Note:
Executing this icon has the same effect like executing the command
cvs tag <tagname> <files>
within an archive OS/2 Window.
See also
tag source files
ΓòÉΓòÉΓòÉ 1.4.4.12. Generate Change Report ΓòÉΓòÉΓòÉ
This object generates a HTML report form, that enables you to report changes,
that you have committed to a CVS archive on the OS/2 Netlabs Open Source
Archive, to the change report database via email.
It depends on the project team, wether your project uses such reports or not.
If your project team decides not to use change reports, simply ignore this
icon.
Note:
Executing this icon has the same effect like executing the command
cvsreport
within an archive OS/2 Window.
See also
generate a change report
ΓòÉΓòÉΓòÉ 1.4.4.13. Remove file ΓòÉΓòÉΓòÉ
This object removes files, or better: marks files as removed within a CVS
archive on the OS/2 Netlabs Open Source Archive server.
Note:
Executing this icon has the same effect like executing the command
cvs remove <files>
within an archive OS/2 Window.
See also
remove source files
ΓòÉΓòÉΓòÉ 1.4.4.14. View modules ΓòÉΓòÉΓòÉ
This object displays modules defined for a CVS archive on the OS/2 Netlabs Open
Source Archive server.
See also
View archive modules
ΓòÉΓòÉΓòÉ 1.4.4.15. OS/2 Window ΓòÉΓòÉΓòÉ
This object open an OS/2 Window being set up for access on a CVS archive on the
OS/2 Netlabs Open Source Archive server.
See also
The archive OS/2 Window
ΓòÉΓòÉΓòÉ 1.5. Usage ΓòÉΓòÉΓòÉ
Select one of the following topics:
The archive list file
- Update the archive list file
- View the archive list
Update the Current Archive Folder
Using an OS/2 Netlabs CVS archive
- CVS working directory
- CVS managment directories
- CVS archive modules
- Using CVS snapshots
- Global CVS options
- Using an archive folder
- Readonly CVS archive access operations
- Read/Write CVS archive access operations
ΓòÉΓòÉΓòÉ 1.5.1. The archive list file ΓòÉΓòÉΓòÉ
The OS/2 Netlabs Open Source Archive Client comes with a file named
archive.lst, which contains a list of the current archives available on the
OS/2 Netlabs Open Source Archive server. This list also contains the complete
name of the rootdirectory of each CVS archive, which is necessary for CVS to
function properly.
Note:
If this file is not present, the OS/2 Netlabs Open Source Archive Client
will not function properly.
See also
Update the archive list file
View the archive list
ΓòÉΓòÉΓòÉ 1.5.1.1. Update the archive list file ΓòÉΓòÉΓòÉ
The archive list file can be outdated due to some reasons:
a new archive has been established at OS/2 Netlabs, which you might be
interested to have a look at.
the rootdirectory of an CVS archive has moved, so that the old name being
stored on your computer is not longer valid.
In both situations it is quite easy to update the list file from the FTP
server of OS/2 Netlabs. Just perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
execute the icon
Update the Open Source Archive list from OS/2 Netlabs
Note:
If you have other NOSA-like archive servers beside the one from OS/2
Netlabs, you can specify multiple hostnames separated by commas within
the installation program. When updating the archive list file, it will be
assembled from the lists of all servers, that could be queried
successfully. Entries in the list coming from servers, that could not be
reached, remain untouched.
See also
The archive list file
View the archive list
Update the Current Archive Folder
ΓòÉΓòÉΓòÉ 1.5.1.2. View the archive list ΓòÉΓòÉΓòÉ
In order to view the archives list file, that is being stored on your computer,
perform the following steps:
open the OS/2 Netlabs Open Source Archive Client folder
execute the icon
View the OS/2 Netlabs Open Source Archive list
See also
The archive list file
Update the archive list file
ΓòÉΓòÉΓòÉ 1.5.2. Update the Current Archive Folder ΓòÉΓòÉΓòÉ
You can rebuild the complete OS/2 Netlabs Open Source Archive Client folder at
any time, in case that
you got lost some icons
or that an updated archive list file contains the name of a new source
archive available on the OS/2 Netlabs Open Source Archive server.
In order to update the complete folder, perform the following steps:
open the OS/2 Netlabs Open Source Archive Client folder
execute the icon
Update Current Archive folder
As an alternative, you can do the same via commandline:
open an OS/2 Window
change to the directory, where the files of the OS/2 Netlabs Open Source
Archive Client reside
execute the command
cvswps
Note:
You do not need to have an active internet connection in order to update
the OS/2 Netlabs Open Source Archive Client, as only the archive list
file already being stored on your computer is used.
See also
Using an OS/2 Netlabs CVS archive
Using an archive folder
The archive list file
Update the archive list file
View the archive list
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.5.3. Using an OS/2 Netlabs CVS archive ΓòÉΓòÉΓòÉ
For accessing a remote CVS archive, you will need some basic CVS knowledge,
even when OS/2 Netlabs Open Source Archive Client eases the access to it by
providing a simple WPS interface. Please read the following sections:
CVS working directory
CVS managment directories
CVS archive modules
Using CVS snapshots
Global CVS options
Depending on which type of access you have, refer to:
Readonly CVS archive access operations
Read/Write CVS archive access operations
See also
Using an archive folder
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.5.3.1. CVS working directory ΓòÉΓòÉΓòÉ
CVS needs a working directory, when it is to perform actions on a CVS archive.
During installation of the OS/2 Netlabs Open Source Archive Client, you have
specified a working directory on your harddisk, where the subdirectories for
each archive are to be created. These subdirectories are not created at once,
but only when you perform any CVS operation on a certain CVS archive through
the icons of the OS/2 Netlabs Open Source Archive Client folder.
For example, if you specified c:\work as the working directory during
installation of the OS/2 Netlabs Open Source Archive Client and you perform a
CVS action by using the corresponding archive folder for an archive called
Odin32, the subdirectory c:\work\odin32 will be created automatically.
ΓòÉΓòÉΓòÉ 1.5.3.2. CVS managment directories ΓòÉΓòÉΓòÉ
When you check out a CVS archive to your working directory, you will notice
that under each source directory there exists a directory named CVS, which
contains three files.
These files keep track of what versions of source files you have currently
checked out, so that when you commit the changes, that you have made to the
source files, CVS, knows what to modify in the archive.
Note:
Do not modify the files in the CVS management directories. It is likely
that CVS cannot properly update your changes to the archive correctly, if
these files contain invalid intformation, which may result in loss of
data.
More, a special directory CVSROOT exists directly under your working
directory, which contains the administration database for the archive. These
files are to change only by the OS/2 Netlabs Open Source Archive
Administrator. While you can check out and view these files, you won't have
write access to commit changes for these files
ΓòÉΓòÉΓòÉ 1.5.3.3. CVS archive modules ΓòÉΓòÉΓòÉ
The administrator of a CVS archive can create administration modules for to
ease the handling of large archives. It is possible to group certain
directories and single files or group of files together in modules, which can
for example be checked out and updated in one operation.
If you checkout a module, it will always appear as a subdirectory below the
working directory of that CVS archive. At the same time, each subdirectory
already existing within an archive can as well be treaded as a module by
specifying its pathname relative to the working directory.
Note:
Whenever you can perform CVS operations onto a single file, you always
can perform them on subdirectories or modules, which will cause CVS to
perform them on all files within and all files in directories below the
specified subdirectory or module.
If you want to perform an operation on a complete CVS archive, just
specify a single dot (placeholder for current directory).
ΓòÉΓòÉΓòÉ 1.5.3.4. Using CVS snapshots ΓòÉΓòÉΓòÉ
If you are accessing a CVS archive on the OS/2 Netlabs Open Source Archive
server for the first time or after a while, you may want to avoid to download
all the (changed) files within the archive via CVS commands.
Instead, you can use snapshots from the archive, that have been taken by the
CVS administrator recently. Such files are provided as zip files on the Netlabs
FTP server.
Using them requires to download that single snapshot file via FTP and unpacking
it in your (empty !) working directory. In order to use the snapshot on your
local harddisk, you only have to fix the CVS management directories within the
directory structure by executing a simple command first.
After that you can perform an update, which will need to fetch much fewer files
from the archive directly via CVS than without using the snapshot.
In order to use a snapshot of a CVS archive, perform the following steps:
download the snapshot zip file from the OS/2 Netlabs Open Source Archive
server
open the OS/2 Netlabs Open Source Archive Client folder
execute the icon
OS/2 Window
delete all files in the working directory.
Note: MAKE SURE THAT YOU HAVE COMMITTED ALL FILE CHANGES TO THE ARCHIVE
BEFORE DELETING YOUR LOCAL FILES !
unzip the snapshot zip file into the empty archive.
execute the command
cvsenv $FIX
or execute the icon
Fix Snapshot
in the OS/2 Netlabs Open Source Archive Client folder in order to make
the snapshot be useable on your local disk.
ΓòÉΓòÉΓòÉ 1.5.3.5. Global CVS options ΓòÉΓòÉΓòÉ
In order to edit the global CVS options used by the OS/2 Netlabs Open Source
Archive Client, perform the following steps:
open the OS/2 Netlabs Open Source Archive Client folder
execute the icon
Edit CVS configuration
See the CVS reference sections for more information:
Default options and the ~/.cvsrc file
ΓòÉΓòÉΓòÉ 1.5.3.6. Using an archive folder ΓòÉΓòÉΓòÉ
The OS/2 Netlabs Open Source Archive Client provides an archive folder for each
source archive available on the OS/2 Netlabs Open Source Archive server. Such a
folder contains several icons for a quick and easy access to these archives,
alowing you to perform most CVS commands without having to use the commandline.
You may either enter the names of files and/or directories manually or
drag&drop them onto the icons within the archive folder.
Nevertheless you can still do that (and for some complex operations, you have
to do so) on a command line, for which an archive folder provides you with an
OS/2 Window icon being completely setup for CVS access to that archive.
In order to open an archive folder perform the following steps:
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
and open the archive folder of the project, on which archive you want to
perform CVS operations
The following Workplace Shell objects are provided within an archive folder:
Login
Logout
Checkout file
Fix Snapshot
View file log
Query file status
Add new file
Update local files
Merge to local files
Commit file changes
Tag file
Generate Change Report
Remove file
View modules
OS/2 Window
More, a shadow to the working directory of the archive on your computer is
created. You can drag&drop both local files and directories below the working
directory to the objects in the archive folder. In this case ignore the prompt
for file/modulenames.
Note:
Of course you will need to have an active internet connection in order to
access the OS/2 Netlabs Open Source Archive.
See also
Using an OS/2 Netlabs CVS archive
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.5.3.7. Readonly CVS archive access operations ΓòÉΓòÉΓòÉ
Most users will have readonly access to source archives on the OS/2 Netlabs
Open Source Archive server, as write access is restricted only to the developer
of a program or some of the the developers joining the current development team
of a larger project. With readonly access, you will only be able to checkout
the current state of the project's source.
The following sections apply to users with both readonly and read/write
permissions:
workflow for download of a CVS archive
Logging into the CVS server
Logging out of the CVS server
Checkout source files
Update source files
view CVS log of source files
view CVS status of source files
View archive modules
The archive OS/2 Window
See also
Using an archive folder
Read/Write CVS archive access operations
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.5.3.7.1. workflow for download of a CVS archive ΓòÉΓòÉΓòÉ
If you just want to have a look at one of the CVS archive on the OS/2 Netlabs
Open Source Archive server, the workflow is as follows:
login into a CVS archive of the OS/2 Netlabs Open Source Archive server.
checkout and/or update a file from a CVS archive on the OS/2 Netlabs Open
Source Archive. In order to speed things up a little bit, you may want to
use a snapshot of the archive instead of downloading file by file with
CVS.
If you participate within a project, see also
workflow for download of a CVS archive
ΓòÉΓòÉΓòÉ 1.5.3.7.2. Logging into the CVS server ΓòÉΓòÉΓòÉ
Before having access to a remote CVS archive, you'll have to login to the OS/2
Netlabs Open Source Archive server.
In order to login into a CVS archive on the OS/2 Netlabs Open Source Archive
server, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, for which archive you want to
login
execute the icon
<archive name> Login
Note:
Executing this icon has the same effect like executing the command
cvs login
within an archive OS/2 Window.
If you have readonly access, specify the password readonly
If you have read/write access, specify the password being sent to you
from your CVS archive administrator.
The password, that you specify, is being stored in the file .cvspass in
the directory being specified as your home directory during the
installation of the OS/2 Netlabs Open Source Archive Client. Unless you
do a CVS logout, this stored password is used to perform CVS operations
on that archive. It even remains stored and keeps being used, if you
interrupt the internet connection or even reboot your system.
See also
Logging out of the CVS server
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.5.3.7.3. Logging out of the CVS server ΓòÉΓòÉΓòÉ
If you do not longer need access to a CVS archive, logout.
In order to logout from a CVS archive on the OS/2 Netlabs Open Source Archive
server, perform the following steps:
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, for which archive you want to
login
execute the icon
<archive name> Logout
Note:
Executing this icon has the same effect like executing the command
cvs logout
within an archive OS/2 Window.
If you logout of an archive, the password will be deleted from the file
.cvspass in the directory being specified as your home directory during
the installation of the OS/2 Netlabs Open Source Archive Client.
If you log out and are not currently logged in, CVS will complain, that
it cannot find the appropriate entry in %HOME%\.cvspass, as it is already
deleted.
See also
Logging into the CVS server
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.5.3.7.4. Checkout source files ΓòÉΓòÉΓòÉ
The checkout command will download some files or the whole contents of a CVS
archive to the working directory of a CVS archive.
In order to checkout files from a CVS archive on the OS/2 Netlabs Open Source
Archive server, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, of which archive you want to
checkout files
execute the icon
<archive name> Checkout file
specify one or more filenames or module names with the pathname relative
to the working directory of the archive on your harddisk. If you want to
checkout a specific revision, specify -r <revisionname> right before the
filename(s).
If you do not specify either file- or modulenames, the complete archive
will be checked out.
Note:
Executing this icon has the same effect like executing the command
cvs checkout <files>
within an archive OS/2 Window.
instead of manually entering the files when being prompted, you also
drag&drop files and directories below the working directory. In this case
just press enter, when the prompt for filenames appear.
Only the files, that are not already on your system or are outdated, are
transferred via internet.
The date- and timestamps of the files represent always the point of time
when you downloaded the files. This is due to the fact, that CVS does not
rely on them.
See also
Update source files
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.5.3.7.5. Update source files ΓòÉΓòÉΓòÉ
The update command will download files, that have been modified in the CVS
archive since you checked them out or updated them the last time, to the
working directory of a CVS archive.
In order to update files from a CVS archive on the OS/2 Netlabs Open Source
Archive server, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, of which archive you want to
checkout files
execute the icon
<archive name> Update local files
specify one or more filenames or module names with the pathname relative
to the working directory of the archive on your harddisk
If you do not specify either file- or modulenames, the complete archive
will be updated.
Note:
Executing this icon has the same effect like executing the command
cvs update <files>
within an archive OS/2 Window.
instead of manually entering the files when being prompted, you also
drag&drop files and directories below the working directory. In this case
just press enter, when the prompt for filenames appear.
Only the files, that are not already on your system or are outdated, are
transferred via internet.
The date- and timestamps of the files represent always the point of time
when you downloaded the files. This is due to the fact, that CVS does not
rely on them.
See also
Checkout source files
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.5.3.7.6. view CVS log of source files ΓòÉΓòÉΓòÉ
You can view the log for all files in the archive, that includes the revision
history and tags being given to certain revisions for each file.
In order to view the log for files from a CVS archive on the OS/2 Netlabs Open
Source Archive server, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, of which archive you want to
checkout files
execute the icon
<archive name> View file log
specify one or more filenames or module names with the pathname relative
to the working directory of the archive on your harddisk
Note:
Executing this icon has the same effect like executing the command
cvs log <files>
within an archive OS/2 Window.
instead of manually entering the files when being prompted, you also
drag&drop files and directories below the working directory. In this case
just press enter, when the prompt for filenames appear.
If you do not specify either file- or modulenames, the log will be
fetched for the complete archive, which will mostly take some amount of
time.
See also
Checkout source files
Update source files
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.5.3.7.7. view CVS status of source files ΓòÉΓòÉΓòÉ
You can view the status for (all) local files in the archive, so that you can
determine, which files you have changed locally or which are outdated compared
to the archive.
In order to view the change status for files from a CVS archive on the OS/2
Netlabs Open Source Archive server, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, of which archive you want to
checkout files
execute the icon
<archive name> Query file status
specify one or more filenames or module names with the pathname relative
to the working directory of the archive on your harddisk
Note:
Executing this icon has the same effect like executing the command
cvs status <files>
within an archive OS/2 Window.
instead of manually entering the files when being prompted, you also
drag&drop files and directories below the working directory. In this case
just press enter, when the prompt for filenames appear.
If you do not specify either file- or modulenames, the status will be
fetched for all files of the complete archive, which will mostly take
some amount of time.
The file status will report both the revisions of the file on your computer
and that of the file in the archive. More, it reports the file status
concerning the CVS operation, that might be reuired for either retrieving a
more actual version or for commiting your changes to the archive. Here is a
little excerpt from the CVS reference:
Up-to-date
The file is identical with the latest revision in the repository for the
branch in use.
Locally Modified
You have edited the file, and not yet committed your changes.
Locally Added
You have added the file with add, and not yet committed your changes.
Locally Removed
You have removed the file with remove, and not yet committed your
changes.
Needs Checkout
Someone else has committed a newer revision to the repository. The name
is slightly misleading; you will ordinarily use update rather than
checkout to get that newer revision.
Needs Patch
Like Needs Checkout, but the CVS server will send a patch rather than the
entire file. Sending a patch or sending an entire file accomplishes the
same thing.
Needs Merge
Someone else has committed a newer revision to the repository, and you
have also made modifications to the file.
File had conflicts on merge
This is like Locally Modified, except that a previous update command gave
a conflict. If you have not already done so, you need to resolve the
conflict as described in Conflicts example.
Unknown
CVS doesn't know anything about this file. For example, you have created
a new file or directory and have not run the CVS command add.
See also
Checkout source files
Update source files
commit changes to the CVS server
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.5.3.7.8. View archive modules ΓòÉΓòÉΓòÉ
In order to view the modules currently defined for a CVS archive on the OS/2
Netlabs Open Source Archive server, perform the following steps:
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, for which archive you want to
login
execute the icon
<archive name> View modules
Note:
The list being displayed reflects the contents of the file
CVSROOT\modules below the working directory of that CVS archive. Make
sure that you update that file before reyling on the output.
See also
Logging out of the CVS server
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.5.3.7.9. The archive OS/2 Window ΓòÉΓòÉΓòÉ
Although the OS/2 Netlabs Open Source Archive Client provides an easy to use
interface for to handle all CVS operations for you, in special cases it might
be easier to execute the CVS manually on the commandline.
For this the OS/2 Netlabs Open Source Archive Client offers an icon, which
opens an OS/2 window having setup the complete environment, which is needed to
access an archive on the OS/2 Netlabs Open Source Archive server. You can
perform all CVS operations within this window.
In order to open an archive OS/2 window for to access a CVS archive on the OS/2
Netlabs Open Source Archive server via commandline, perform the following
steps:
make sure that you have an active connection to the internet, if you want
to perform remote CVS operations within the window
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, which you want to access
execute the icon
<archive name> OS/2 Window
ΓòÉΓòÉΓòÉ 1.5.3.8. Read/Write CVS archive access operations ΓòÉΓòÉΓòÉ
Developers participating with a project will have (partial) readwrite access to
source archives on the OS/2 Netlabs Open Source Archive server. With such
read/write access, they will be able to commit changes to source files either
within a whole archive or only within certain directories of an archive, where
access restrictions are setup by the OS/2 Netlabs Open Source Archive
Administrator.
Beside the sections for Readonly CVS archive access operations also the
following sections apply to users with read/write permissions:
workflow for modifications within an CVS archive
add new source files
merge local files
commit changes to the CVS server
tag source files
generate a change report
remove source files
See also
Using an archive folder
Readonly CVS archive access operations
The archive OS/2 Window
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.5.3.8.1. workflow for modifications within an CVS archive ΓòÉΓòÉΓòÉ
Developers with read/write access have to follow a certain path in order to
modify files in a CVS archive on the OS/2 Netlabs Open Source Archive server.
The workflow is as follows:
login into a CVS archive of the OS/2 Netlabs Open Source Archive server.
checkout and/or update a file from a CVS archive on the OS/2 Netlabs Open
Source Archive, if you need to modify a file already existing within the
archive. Skip this point, when you need to create a new file.
In order to speed things up a little bit, you may want to use a snapshot
of the archive instead of downloading file by file with CVS.
create or edit the appropriate files with any program.
If you have created a new file or directory, add the file or directory to
the archive now. Make sure, that you disable keyword expansion for binary
files here by specifying the option -kb right before the filename.
merge your changes with the changes, that other developers might have
committed meanwhile to the archive, and check, if the merged source(s)
still work. If you are not sure, wether a file needs a merge or not,
request the CVS file status for this file.
commit your changes to the CVS archive on the OS/2 Netlabs Open Source
Archive
tag the created or modified file(s) with a label, so that others can
easily checkout your modifications, no matter how much files you have
changed. Ask your OS/2 Netlabs Open Source Archive administrator for
naming conventions for tag names.
Generate a change report and send it to the change report database via
email in order to ease the CVS maintainers job to integrate your changes
into a new release build.
It depends on the project team, wether your project uses such reports or
not. If your project team decides not to use change reports, simply
ignore this part.
ΓòÉΓòÉΓòÉ 1.5.3.8.2. add new source files ΓòÉΓòÉΓòÉ
Developers often need to be able to add new files and directories to the
archive, using the add command.
Note: For this you need to have write access to the CVS archive
In order to add a new file or directory to a CVS archive on the OS/2 Netlabs
Open Source Archive server, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, of which archive you want to add
files or directories to
execute the icon
<archive name> Add new file
specify one or more filenames relative to the working directory of the
archive on your harddisk
Note:
Executing this icon has the same effect like executing the command
cvs add <files|directories>
within an archive OS/2 Window.
instead of manually entering the files when being prompted, you also
drag&drop files and directories below the working directory. In this case
just press enter, when the prompt for filenames appear.
Make sure, that you disable keyword expansion for binary files here by
specifying the option -kb right before the filename.
ΓòÉΓòÉΓòÉ 1.5.3.8.3. merge local files ΓòÉΓòÉΓòÉ
If another developer has committed changes to a file, while you have had
checked it out and changed it, you have to merge the changes of others into
your version of the file before committing your changes.
After CVS. merged the changes of the other developers to your local file, you
have to make sure, that it still works. (compiles etc.).
Note: For this you need to have write access to the CVS archive
In order to merge file changes in a CVS archive on the OS/2 Netlabs Open Source
Archive server to your local file, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, to which archive you have added
files or directories to
execute the icon
<archive name> Merge to local files
specify one or more filenames relative to the working directory of the
archive on your harddisk
Note:
Executing this icon has the same effect like executing the command
cvs update <files|directories>
within an archive OS/2 Window.
instead of manually entering the files when being prompted, you also
drag&drop files and directories below the working directory. In this case
just press enter, when the prompt for filenames appear.
If you are not sure, wether a file needs a merge or not, you can query
the CVS file status for this file before.
Althouth there exist two icons for updating a local file and merging to a
local file within the OS/2 Netlabs Open Source Archive Client folder,
they actually execute the same CVS command, namely update.
ΓòÉΓòÉΓòÉ 1.5.3.8.4. commit changes to the CVS server ΓòÉΓòÉΓòÉ
After having added new files and directories or modified locally checked out
files , you have to commit the changes to the CVS archive, otherwise these
changes will stay on your local harddisk and noone will see them within the
archive.
Note: For committing file changes you need to have write access to the CVS
archive
In order to commit changes to a CVS archive on the OS/2 Netlabs Open Source
Archive server, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, to which archive you have added
files or directories to
execute the icon
<archive name> Commit file changes
specify one or more filenames relative to the working directory of the
archive on your harddisk
Note:
Executing this icon has the same effect like executing the command
cvs commit <files>
within an archive OS/2 Window.
instead of manually entering the files when being prompted, you also
drag&drop files and directories below the working directory. In this case
just press enter, when the prompt for filenames appear.
ΓòÉΓòÉΓòÉ 1.5.3.8.5. tag source files ΓòÉΓòÉΓòÉ
After having committed file changes, you should tag the created or modified
file(s) with a label, so that others can easily checkout your modifications, no
matter how much files you have changed.
Note: For tagging files you need to have write access to the CVS archive
Ask your OS/2 Netlabs Open Source Archive administrator for naming conventions
for tag names.
Normally, only the owner of the archive is allowed to freely use all sorts of
tag names in order to protect tags for release versions from being moved by
accident. Developers participating the project are mostly restricted to use
only tag names preceeded by their user id.
In order to tag files within a CVS archive on the OS/2 Netlabs Open Source
Archive server, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, of which archive you want to tag
files in
execute the icon
<archive name> Tag file
specify the tag name (see comment above for naming conventions) and the
-d option, if you want to delete a tag
specify one or more filenames relative to the working directory of the
archive on your harddisk
Note:
Executing this icon has the same effect like executing the command
cvs tag <tagname> <files>
within an archive OS/2 Window.
instead of manually entering the files when being prompted, you also
drag&drop files and directories below the working directory. In this case
just press enter, when the prompt for filenames appear.
tag operations need not to be commited, as they are directly performed on
the CVS archive
ΓòÉΓòÉΓòÉ 1.5.3.8.6. generate a change report ΓòÉΓòÉΓòÉ
After having committed file changes, and tagged the changed files, you should
report this change to the OS/2 Netlabs Open Source Archive change report
database, if your project makes use of them. It depends on the project team,
wether your project uses such reports or not. If your project team decides not
to use change reports, simply ignore this part.
In order to create a change report for a CVS archive on the OS/2 Netlabs Open
Source Archive server, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, of which archive you want to tag
files in
execute the icon
<archive name> Generate Change Report
Now wait for the internet browser to come up with the change report form. Fill
out the entry fields with the appropriate information and submit the form in
order to send the change report via email.
Note:
You will need to have an active internet connection in order to be able
to send an email.
Executing this icon has the same effect like executing the command
cvsreport
within an archive OS/2 Window.
ΓòÉΓòÉΓòÉ 1.5.3.8.7. remove source files ΓòÉΓòÉΓòÉ
From while to while you may need to remove files from the archive, because it
has become obsolete. In fact, if you call CVS to remove a file, it is only
marked as being removed, but the file still remains in the archive in order to
keep older versions complete.
Note: For marking files as being removed you need to have write access to the
CVS archive
In order to mark files as being removed from a CVS archive on the OS/2 Netlabs
Open Source Archive server, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, of which archive you want to tag
files in
execute the icon
<archive name> Remove file
specify one or more filenames relative to the working directory of the
archive on your harddisk
Note:
Executing this icon has the same effect like executing the command
cvs remove <files>
within an archive OS/2 Window.
instead of manually entering the files when being prompted, you also
drag&drop files and directories below the working directory. In this case
just press enter, when the prompt for filenames appear.
Remove operations need not to be commited, as they are directly performed
on the CVS archive
ΓòÉΓòÉΓòÉ 1.6. How can I ... ? ΓòÉΓòÉΓòÉ
Select one of the following topics:
How can I solve the 'Too many open files' problem ?
How can I update the archive list ?
How can I view the archive list ?
How can I use an archive folder ?
How can I use an OS/2 Netlabs CVS archive
How can I login into an OS/2 Netlabs CVS archive ?
How can I download source from an OS/2 Netlabs CVS archive ?
How can I use a CVS snapshot from an OS/2 Netlabs CVS archive ?
How can I modify source within an OS/2 Netlabs CVS archive ?
How can I perform CVS operations onto an OS/2 Netlabs CVS archive ?
How can I generate a change report ?
How can I modify global CVS options ?
ΓòÉΓòÉΓòÉ 1.6.1. How can I solve the 'Too many open files' problem ? ΓòÉΓòÉΓòÉ
If CVS displays the message "To many open files", you must increase the default
file handle limit of the EMX Runtime.
In order to do so, add the following environment variable to your CONFIG.SYS:
SET EMXOPT=-c -n -h1024
where
-c disables core dumps caused by signals and exceptions (they are only
really useful if you use debug versions of a software).
-n Suppress popups for exceptions. As emx.dll displays an appropriate
error message, popups are not required.
-h1024 Set OS/2 file handle limit for CVS (and other EMX based programs)
to 1024, thus eliminating your current problem. The number must be
between 10 and 65536, possibly CVS will also run with a smaller
value.
See also the file doc\emxrt.doc of the EMX Runtime for further details on
values of the EMXOPT environment variable.
ΓòÉΓòÉΓòÉ 1.6.2. How can I update the archive list ? ΓòÉΓòÉΓòÉ
In order to update the list file from the FTP server of OS/2 Netlabs, just
perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
execute the icon
Update the Open Source Archive list from OS/2 Netlabs
See also
Update the archive list file
ΓòÉΓòÉΓòÉ 1.6.3. How can I view the archive list ? ΓòÉΓòÉΓòÉ
In order to view the archives list file, that is being stored on your computer,
perform the following steps:
open the OS/2 Netlabs Open Source Archive Client folder
execute the icon
View the OS/2 Netlabs Open Source Archive list
See also
The archive list file
Update the archive list file
ΓòÉΓòÉΓòÉ 1.6.4. How can I use an archive folder ? ΓòÉΓòÉΓòÉ
The OS/2 Netlabs Open Source Archive Client provides an archive folder for each
source archive available on the OS/2 Netlabs Open Source Archive server. Such a
folder contains several icons for a quick and easy access to these archives,
alowing you to perform most CVS commands without having to use the commandline.
You may either enter the names of files and/or directories manually or
drag&drop them onto the icons within the archive folder.
Nevertheless you can still do that (and for some complex operations, you have
to do so) on a command line, for which an archive folder provides you with an
OS/2 Window icon being completely setup for CVS access to that archive.
In order to open an archive folder perform the following steps:
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
and open the archive folder of the project, on which archive you want to
perform CVS operations
The following Workplace Shell objects are provided within an archive folder:
Login
Logout
Checkout file
Fix Snapshot
View file log
Query file status
Add new file
Update local files
Merge to local files
Commit file changes
Tag file
Generate Change Report
Remove file
View modules
OS/2 Window
More, a shadow to the working directory of the archive on your computer is
created. You can drag&drop both local files and directories below the working
directory to the objects in the archive folder. In this case ignore the prompt
for file/modulenames.
Note:
Of course you will need to have an active internet connection in order to
access the OS/2 Netlabs Open Source Archive.
See also
Using an OS/2 Netlabs CVS archive
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.6.5. How can I login into an OS/2 Netlabs CVS archive ? ΓòÉΓòÉΓòÉ
In order to login into a CVS archive on the OS/2 Netlabs Open Source Archive
server, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, for which archive you want to
login
execute the icon
<archive name> Login
See also
Logging into the CVS server
Logging out of the CVS server
ΓòÉΓòÉΓòÉ 1.6.6. How can I use an OS/2 Netlabs CVS archive ΓòÉΓòÉΓòÉ
For accessing a remote CVS archive, you will need some basic CVS knowledge,
even when OS/2 Netlabs Open Source Archive Client eases the access to it by
providing a simple WPS interface. Please read the following sections:
CVS working directory
CVS managment directories
CVS archive modules
Using CVS snapshots
Global CVS options
Depending on which type of access you have, refer to:
Readonly CVS archive access operations
Read/Write CVS archive access operations
See also
Using an archive folder
Concurrent Versions System (CVS)
ΓòÉΓòÉΓòÉ 1.6.7. How can I download source from an OS/2 Netlabs CVS archive ? ΓòÉΓòÉΓòÉ
If you just want to have a look at one of the CVS archive on the OS/2 Netlabs
Open Source Archive server, the workflow is as follows:
login into a CVS archive of the OS/2 Netlabs Open Source Archive server.
checkout and/or update a file from a CVS archive on the OS/2 Netlabs Open
Source Archive. In order to speed things up a little bit, you may want to
use a snapshot of the archive instead of downloading file by file with
CVS.
If you participate within a project, see also
modify source within an OS/2 Netlabs CVS archive ?
ΓòÉΓòÉΓòÉ 1.6.8. How can I use a CVS snapshot from an OS/2 Netlabs CVS archive ? ΓòÉΓòÉΓòÉ
If you are accessing a CVS archive on the OS/2 Netlabs Open Source Archive
server for the first time or after a while, you may want to avoid to download
all the (changed) files within the archive via CVS commands.
Instead, you can use snapshots from the archive, that have been taken by the
CVS administrator recently. Such files are provided as zip files on the Netlabs
FTP server.
Using them requires to download that single snapshot file via FTP and unpacking
it in your (empty !) working directory. In order to use the snapshot on your
local harddisk, you only have to fix the CVS management directories within the
directory structure by executing a simple command first.
After that you can perform an update, which will need to fetch much fewer files
from the archive directly via CVS than without using the snapshot.
In order to use a snapshot of a CVS archive, perform the following steps:
download the snapshot zip file from the OS/2 Netlabs Open Source Archive
server
open the OS/2 Netlabs Open Source Archive Client folder
execute the icon
OS/2 Window
delete all files in the working directory.
Note: MAKE SURE THAT YOU HAVE COMMITTED ALL FILE CHANGES TO THE ARCHIVE
BEFORE DELETING YOUR LOCAL FILES !
unzip the snapshot zip file into the empty archive.
execute the command
cvsenv $FIX
or execute the icon
Fix Snapshot
in the OS/2 Netlabs Open Source Archive Client folder in order to make
the snapshot be useable on your local disk.
ΓòÉΓòÉΓòÉ 1.6.9. How can I modify source within an OS/2 Netlabs CVS archive ? ΓòÉΓòÉΓòÉ
Developers with read/write access have to follow a certain path in order to
modify files in a CVS archive on the OS/2 Netlabs Open Source Archive server.
The workflow is as follows:
login into a CVS archive of the OS/2 Netlabs Open Source Archive server.
checkout and/or update a file from a CVS archive on the OS/2 Netlabs Open
Source Archive, if you need to modify a file already existing within the
archive. Skip this point, when you need to create a new file.
In order to speed things up a little bit, you may want to use a snapshot
of the archive instead of downloading file by file with CVS.
create or edit the appropriate files with any program.
If you have created a new file or directory, add the file or directory to
the archive now. Make sure, that you disable keyword expansion for binary
files here by specifying the option -kb right before the filename.
merge your changes with the changes, that other developers might have
committed meanwhile to the archive, and check, if the merged source(s)
still work. If you are not sure, wether a file needs a merge or not,
request the CVS file status for this file.
commit your changes to the CVS archive on the OS/2 Netlabs Open Source
Archive
tag the created or modified file(s) with a label, so that others can
easily checkout your modifications, no matter how much files you have
changed. Ask your OS/2 Netlabs Open Source Archive administrator for
naming conventions for tag names.
Generate a change report and send it to the change report database via
email in order to ease the CVS maintainers job to integrate your changes
into a new release build.
It depends on the project team, wether your project uses such reports or
not. If your project team decides not to use change reports, simply
ignore this part.
ΓòÉΓòÉΓòÉ 1.6.10. How can I perform CVS operations onto an OS/2 Netlabs CVS archive ? ΓòÉΓòÉΓòÉ
Although the OS/2 Netlabs Open Source Archive Client provides an easy to use
interface for to handle all CVS operations for you, in special cases it might
be easier to execute the CVS manually on the commandline.
For this the OS/2 Netlabs Open Source Archive Client offers an icon, which
opens an OS/2 window having setup the complete environment, which is needed to
access an archive on the OS/2 Netlabs Open Source Archive server. You can
perform all CVS operations within this window.
In order to open an archive OS/2 window for to access a CVS archive on the OS/2
Netlabs Open Source Archive server via commandline, perform the following
steps:
make sure that you have an active connection to the internet, if you want
to perform remote CVS operations within the window
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, which you want to access
execute the icon
<archive name> OS/2 Window
ΓòÉΓòÉΓòÉ 1.6.11. How can I generate a change report ? ΓòÉΓòÉΓòÉ
After having committed file changes, and tagged the changed files, you should
report this change to the OS/2 Netlabs Open Source Archive change report
database, if your project makes use of them. It depends on the project team,
wether your project uses such reports or not. If your project team decides not
to use change reports, simply ignore this part.
In order to create a change report for a CVS archive on the OS/2 Netlabs Open
Source Archive server, perform the following steps:
make sure that you have an active connection to the internet
open the OS/2 Netlabs Open Source Archive Client folder
open the folder called Current Netlabs Archives
open the archive folder of the project, of which archive you want to tag
files in
execute the icon
<archive name> Generate Change Report
Now wait for the internet browser to come up with the change report form. Fill
out the entry fields with the appropriate information and submit the form in
order to send the change report via email.
Note:
You will need to have an active internet connection in order to be able
to send an email.
Executing this icon has the same effect like executing the command
cvsreport
within an archive OS/2 Window.
ΓòÉΓòÉΓòÉ 1.6.12. How can I modify global CVS options ? ΓòÉΓòÉΓòÉ
In order to edit the global CVS options used by the OS/2 Netlabs Open Source
Archive Client, perform the following steps:
open the OS/2 Netlabs Open Source Archive Client folder
execute the icon
<archive name> Edit CVS configuration
See the CVS reference sections for more information:
Default options and the ~/.cvsrc file
ΓòÉΓòÉΓòÉ 1.7. Limitations ΓòÉΓòÉΓòÉ
The following limitations apply to the current version of OS/2 Netlabs Open
Source Archive Client:
directory names of and within CVS archives may currently not include
blanks. However this restriction does not exist for filenames.
This packages is available only in english. This is due to the reason,
that programmers mostly understand english and that development tools,
such as the required Concurrent Versions System (CVS) are also only
available in english.
the OS/2 Netlabs Open Source Archive Client does not address the need of
reserved checkouts, neither within the WPS folder nor in this online
document. Neither the watch nor the edit command is directly supported by
the OS/2 Netlabs Open Source Archive Client folder, because this would
need at least four more icons and make the folder looking rather
confused.
See the CVS reference sections for more information:
- Multiple developers
- Telling CVS to watch certain files
- How to edit a file which is being watched
ΓòÉΓòÉΓòÉ 1.8. Revision history ΓòÉΓòÉΓòÉ
Select one of the following topics:
file_id.diz
Version 1.06
Version 1.05
Version 1.04
ΓòÉΓòÉΓòÉ 1.8.1. file_id.diz ΓòÉΓòÉΓòÉ
(v1.06) NOSA Client - FREEWARE
The "OS/2 Netlabs Open Source Archive (NOSA)
Client" enables you to download all sources
of the OS/2 Netlabs Open Source Archive,
hosting sources of well known OS/2 internet
projects. This package requires the
Concurrent Versions System (CVS), and eases
the handling for both CVS beginners and pros.
NOSA homepage: httpnetlabs.org
Author: C.Langanke@TeamOS2.de
ΓòÉΓòÉΓòÉ 1.8.2. Version 1.06 ΓòÉΓòÉΓòÉ
New:
all icons with a project folder do not longer use the default command
processor in order to execute cvsenv.cmd, but always CMD.EXE. This was
necessary, because certain command processor replacements have serious
problems with the dollar sign being used within cvsenv commands. For
example, bash as a unix-style command processor treats words beginning
with a dollar sign as environment variables...
The archive list file is not longer being fetched via functions of the
RXFTP.DLL supplied with the TCP/IP package of OS/2, but with the
automated mode of plain FTP.EXE instead.
This is a workaround for that fetching this file with the RXFTP.DLL
coming with WARP Server for e-business did not work properly. Another
workaround is to use RXFTP.DLL from plain WARP 4 client with old versions
of OS/2 Netlabs Open Source Archive Client.
Fixed:
updated the hobbes link to the EMX Runtime and removed the outdated link
to OS/2 Supersite.
ΓòÉΓòÉΓòÉ 1.8.3. Version 1.05 ΓòÉΓòÉΓòÉ
New:
added new sections to this book about the EMX Runtime, wich is a
prerequisite for the Concurrent Versions System (CVS).
See
- EMX Runtime
- Prerequisites
- How can I solve the 'Too many open files' problem ?
You do not longer need to write the cvsenv commands in uppercase. More,
you can use abbreviations, mostly with only one letter behind the dollar
sign (e.g. $L or $list instead odf $LIST).
Take care though, where two commands start with the same letter: in order
to distinct between such commands, you may have to specify more than one
letter of the command name. Execute
cvsenv /?
in order to get an overview of all commands.
enhanced cvsenv so that you now can use multiple hosts (you might have
setup another NOSA-like server for test purposes etc.). Specify multiple
hosts separated by commas when the installation program asks for the NOSA
server.
See also
- Update the archive list file
added default .cvsrc file (CVS options), which is installed, if none is
present
added the following client features
- generate a change report and send it to the change report database
via email. It depends on the project team, wether your project uses
such reports
- fix a snapshot, that has been previously unpacked in the working
directory.
added following icons to the archive folder:
- Generate Change Report
- Fix Snapshot
ΓòÉΓòÉΓòÉ 1.8.4. Version 1.04 ΓòÉΓòÉΓòÉ
First public release
ΓòÉΓòÉΓòÉ 1.9. Trademarks ΓòÉΓòÉΓòÉ
The following trademarks are used in this online help file:
OS/2 is a trademark of IBM Corporation.
ΓòÉΓòÉΓòÉ 1.10. Credits ΓòÉΓòÉΓòÉ
Select one of the following topics:
General credits
ΓòÉΓòÉΓòÉ 1.10.1. General credits ΓòÉΓòÉΓòÉ
Credits go to:
all people having helped the development of this program.
all developers, who share and who will share their code through the OS/2
Netlabs Open Source Archive. You all help the current and wannabe
developers of the OS/2 community building better code, participating
within internet projects and bringing OS/2 forward with new programs,
that we all need.
all developers being ivolved in making
- Concurrent Versions System (CVS)
- Info-Zip
- EMX Runtime
Without these programs, the OS/2 Netlabs Open Source Archive would not
have been possible.