	RCS MAKROT VEDITIIN
	===================

	V2.0  2003-05-20  Pauli Lindgren  (For Vedit 6.0+)

	http://koti.mbnet.fi/pkl/
	e-mail:  pauli.lindgren@mbnet.fi


Tss paketissa olevat makrot toteuttavat Veditiss RCS-tuen.
(Huom. Nm makrot vaativat Veditin version 6.0 tai uudemman.)

Event-makrot hoitavat automaattisesti check-out ja check-in -toiminnot
tiedostoa avatessa ja sulkiessa. Kun olet asentanut makrot, sinun 
tarvitsee vain luoda tyhakemistosi alle hakemisto "RCS", loppu hoituu 
automaattisesti.

Muut makrot toteuttavat ernlaisen graafisen kyttliittymn RCS:n.
Voit antaa RCS komentoja suoraan Veditist menujen ja dialog boxien avulla.

Nykyisess muodossaan makrot on tarkoitettu lhinn henkilkohtaiseen
version hallintaan omalla kovalevyllsi. Jos haluat kytt yhteist
verkossa olevaa RCS-hakemistoa, pitnee makroja hieman muuttaa.

Pakettiin kuuluu seuraavat tiedostot:

 RCS_111.vtm
 RCS_112.vtm
 RCS_113.vtm
	Event-makrot, jotka suorittavat check-in ja check-out toiminnot.
	Lataa nm makrot muistiin kytten makroa RCS_cmd.vdm tai
	RCS_start.vdm, tai sijoita latauskomennot startup.vdm tiedostoon,
	jolloin RCS on aina kytettviss. (Ohjeet alempana.)

 RCS_cmd.vdm
	Avaa dialog boxin, josta voi suorittaa eri RCS toimintoja:
	- Event-makrojen lataus ja poistaminen
	- RLOG (Lista auki olevan tiedoston eri versioista)
	- DIFF (Listaa erot kahden version vlill. Voit mys hypt
	  vastaavaan kohtaan varsinaisessa tiedostossa.

 RCS_start.vdm
	Lataa event-makrot. (Sama toiminto on mys RCS_cmd.vdm makrossa.)
	Voit kopioida tmn tiedoston sislln USTARTUP.VDM tiedostoosi,
	jos haluat, ett RCS-tuki on oletuksena kytss.

 Rdif_gto.vdm
	Tt makroa kutsutaan, kun painat Ctrl-F11 ollessasi katselemassa
	RCSDIFF-ohjelman tuottamaa listaa versioiden eroista. Etsii
	vastaavan kohdan editoitavasta tiedostosta.

 RCSdiff.syn
	Syntax Highlight tiedosto, joka nytt RCSdiff-ohjelman
	tuottaman listauksen vreiss.

 RCSdiff2.syn
	Vaihtoehtoinen syntax-tiedosto, joka nytt muuttamattomat
	rivit C-kielen syntaksivrityksell (tietyin rajoituksin).

 Rlog.syn
	Syntax highlight tiedosto Rlog revisiolistaukselle.

 C_user.mnu (hakemistossa ..\v610\omat\vedit)
	C-kielelle sovitettu User-menu, jossa on mukana RCS_cmd -makron
	kutsu. Voit ladata tmn normaalin User-menun tilalle tai
	kopioida alimmat 3 rivi omaan User-menuusi.

		- - -



	VEDITIN RCS MAKROJEN ASENNUS

Huom. Nm makrot vaativat Veditin version 6.0 tai uudemman.

Asenna ensin RCS (linkkej mist voit imuroida RCS:n lydt
www-sivultani). Asenna sitten Veditin RCS-tuki seuraavasti:

1. Kopioi kaikki tiedostot hakemistosta s:\asenna\vedit\RCS omalle 
   kovalevyllesi Veditin kotihakemiston alla olevaan hakemistoon User-mac.

2. a) Jos haluat, ett automaattinen check-in / check-out on aina
      kytss, kopioi tiedoston RCS_start.vdm sislt Veditin kotihakemistossa
      olevaan USTARTUP.VDM tiedostoon johonkin sopivaan paikkaan.
   
   b) Jos haluat kynnist automaattisen check-in / check-out toiminnan
      vain tarvittaessa, voit kytt siihen esim. User-manua (kts. kohta 3).

3. Jotta RCS-komennot olisivat helposti kytettviss, sijoita kutsu
   User-menuun. Vaihtoehtoja on useita:
   a) Voit kytt oheista C_user.mnu menua: kopioi C_user.mnu veditin
      kotihakemistoon (esim. c:\vedit). Editoi USTARTUP.VDM tiedostoasi:
      Etsi kohta 
	Reg_Set(103,"my-user.mnu")
      poista kommentti ja vaihda nimeksi "C_user.mnu".
   b) Vaihtoehtoisesti voit kopioida C_user.mnu:sta 3 alinta rivi
      omaan user-menuusi.
   c) Tai vaihtoehtoisesti voit ladata C_user.mnu:n kun asetat Veditin
      C-toimintatilaan (kyt esim. konfig.vdm makroa, jota kutsutaan,
      kun valitset "Asetus" user1w.mnu tai user2w.mnu menusta).
   d) Vedit 6.1 tai uudemmassa User-menu tallettuu projektin mukana.


		- - -

	RCS-MAKROJEN KYTT


KYTTNOTTO:

Kun haluat ottaa versionhallinnan kyttn jossain projektissa,
luo projektin tyhakemiston alle hakemisto rcs. Jos hakemistoja
on useita, on rcs alihakemisto oltava jokaisessa. Siin kaikki.


CHECK-IN ja CHECK-OUT:

Voit nyt avata mink tahansa tiedoston Veditiin normaalisti.
Kun suljet tiedoston, avautuu dialog-box, jossa kysytn, haluatko
list tiedoston versionhallintaan. Jos vastaat "Kyll", kysytn
seuraavaksi tiedoston kuvausteksti. Kirjoita lyhyt (1 rivin pituinen)
kuvaus k.o. modulin tarkoituksesta, ja paina sitten OK (tai Enter).
Nyt suoritetaan check-in toiminto.

Kun avaat tiedoston, joka on jo versionhallinnassa, Vedit suorittaa
automaattisesti check-out toiminnon (tst tulee ilmoitus statusriville).

Kun suljet tiedoston uudestaan, avautuu DOS-ikkuna. RCS kysyy nyt
kommenttia siit, mit muutoksia olet tehnyt thn versioon.
Kirjoita yksi tai useampia rivej. Lopuksi syt rivi, jossa on
pelkk piste. Tmn jlkeen suoritetaan check-in ja DOS-ikkuna
sulkeutuu.


MUUT TOIMINNOT:

Muita RCS-toimintoja voit suorittaa makron RCS_cmd.vdm avulla.
Makron voit kynnist helpoimmin valitsemalla User-menusta
vaihtoehdon "RCS".

Jos event-makroja ei ole ladattu, avautuu "RCS versionhallinta" dialog-box, 
joka kysyy, haluatko ladata makrot. 
Valitse [Lataa] tai paina Enter, jos haluat ladata makrot. 
Valitse [Peruuta] tai paina Esc, jos et halua ladata.

Jos event-makrot on jo ladattu, avautuu "RCS versionhallinta" dialog-box, 
jossa on seuraavat painikkeet:

 [Poista]	- Poistaa automaattisen check-in / check-out 
 		  toiminnon kytst.

 [Rlog]		- Listaa kaikki valitun tiedoston versiot (kts. alla)

 [Diff]		- Nytt kahden version vliset erot (kts. alla)

 [Peruuta]	- Peruuttaa toiminnon (voit mys painaa Esc)



RLOG:

Tll painikkeella saat RLOG-listauksen sill hetkell valittuna olevassa
ikkunassa olevasta tiedostosta. (Jos mitn tiedostoa ei ole auki, avautuu
File Open -dialog box tiedoston valitsemiseksi.) 

RLOG nytt listan tiedoston eri versioista. Listaus avautuu omaan 
ikkunaansa. Kun lopetat lukemisen, sulje ikkuna normaalisti esim. klikkaamalla 
ikkunan oikeassa ylkulmassa olevaa [x] painiketta tai valitsemalla menusta
"File" -> "Close". Voit mys jtt ikkunan auki, seuraavat RCS komennot
kyttvt samaa ikkunaa.


DIFF:

Tll painikkeella voit ajaa RCSDIFF ohjelman, joka listaa erot kahden
RCS-tietokannassa olevan version vlill. 

Tiedosto, jonka versioita tutkitaan, on se tiedosto, joka on aktiivisessa 
ikkunassa silloin kun suoritat tmn komennon. Jos yhtn tiedostoa ei
ole auki, avautuu File Open -dialog box, josta voit valita tiedoston.

Nyt avautuu "RCS diff" dialog-box. 

Dialogissa on kaksi syttkentt versionumeroille. 
- Voit verrata kahta revisiota antamalla kentiss niden versionumerot
  (esim. 1.1 ja 1.2).
- Jos sytt vain yhden versionumeron (jompaan kumpaan kenttn),
  verrataan tytiedostoa annettuun versioon.
- Jos et syt kumpaankaan kenttn mitn, verrataan tytiedostoa viimeksi
  jdytettyyn (check-in) versioon.

Jos kohta "Space eroja ei huomioida" on ruksattu, lasketaan useampi
vlilynti yhdeksi, jolloin esim. sisennystason muutoksia ei listata.

Kun klikkaat OK, suoritetaan RCSDIFF-ohjelma, ja sen antama tulostus
avautuu omaan ikkunaansa (read-only moodissa). Voit selata tt
tiedostoa normaalisti. Voit mys halutessasi suurentaa ikkunaa.
Kun lopetat lukemisen, voit sulkea ikkunan (kts. RLOG edell), tai
jtt sen auki.

Kun olet RCSdiff-ikkunassa, voit siirty kursorin osoittamaa muutosta
vastaavalle riville varsinaisessa tiedostossa painamalla Ctrl-F11.


	   - - -

	KONFIGUROINTI:

Voit muuttaa RCS-makrojen toimintaa seuraavasti:

Check-in toiminto:

  Voit valita mit RCS tekee tiedostoa suljettaessa (check-in)
  editoimalla makron RCS_113.vtm alussa olevaa rekisterin #113 asetusta.

   #113 = 0 - normaali check-in toiminto, tiedostosta tulee read-only.
   #113 = 1 - RCS suorittaa check-in ja heti pern check-out, jolloin
	      tiedosto on edelleen editoitavissa. Tm helpottaa esim. useisiin
	      tiedostoihin kerralla tehtvi muutoksia (Wildfile.vdm tms.).


Diff-toiminto:

  Voit valita, onko "Space eroja ei huomioida" kohta oletuksena rastitettu
  editoimalla tiedoston RCS_cmd.vdm alussa olevaa rivi, jossa asetetaan
  rekisterin #90 arvo.

   #90 = 0 - space-erot huomioidaan (ei rastia)
   #90 = 1 - space-eroja ei huomioida (valinta rastitettu)


Syntaksivritys:

   Jos hluat syntaksivrityksen kyttn RLOG ja DIFF toiminnoille,
   toimi seuraavasti:

   1. Suorita (C-User menusta) RCS -> Rlog
   2. Kun versiolistaus on nytss, valitse menusta
       "Misc" -> "Load color syntax file..."
      ja valitse syntaksitiedosto Rlog.syn.
   3. Valitse menusta 
       "Config" -> "File-open config" -> "Save filename specific config".
   4. Varmista ett "Enable file open config" on valittuna "File-open config"
      -menussa.

   Tmn jlkeen syntaksivritys on automaattisesti kytss Rlog-listauksessa.

   Ota kyttn syntaksivritys RCS DIFF-toiminnossa vastaavalla tavalla,
   valitsemalla syntaksitiedostoksi RCSdiff.syn.

	

	HISTORIA:

V1.0	2000-11-07  - Ensimminen versio
V1.1	2001-04-11  - Ikkunoita sdetty, pient viilailua
V2.0	2003-05-20  - Vedit 6.0+ versio,
		      monipuolisempi dialog box, konfigurointioptiot


