Jos lähde- ja kohdetiedostot on annettu, SubWCRev kopioi lähdetiedoston kohdetiedostoksi, suorittaen samalla avainsanojen laajennuksen seuraavasti:
Taulu 6.3. Luettelo käytettävissä olevista avainsanoista
Avainsana | Kuvaus |
---|---|
$WCREV$ | Korvataan työkopion korkeimmalla versionumerolla. |
$WCREV&$ | Korvataan työkopion suurimalla versionumerolla, leikaten merkkiä & seuraavalla arvolla. Esimerkki: $WCREV&0xFFFF$ |
$WCREV-$, $WCREV+$ | Korvataan työkopion suurimalla versionumerolla, johon lisätään (+) tai poistetaan (-) seuraava arvo. Esimerkki: $WCREV-1000$ |
$WCDATE$, $WCDATEUTC$ | Korvataan korkeimman version toimitusaikaleimalla. Oletusarvoisesti käytetään kansainvälistä muotoa yyyy-mm-dd hh:mm:ss . Vaihtoehtoisesti voit määritellä oman muodon, jota käytetään funktion strftime() kanssa. Esimerkki: $WCDATE=%a %b %d %I:%M:%S %p$ . Luettelo tuetuista ohjausmerkeistä löytyy osoitteesta web-käyttöohje. |
$WCNOW$, $WCNOWUTC$ | Korvataan järjestelmän nykyisellä päiväyksellä ja kellonajalla. Tätä voidaan käyttää esim. määrittämään käännösaika. Ajan muotoilu kuten $WCDATE$ yhteydessä. |
$WCRANGE$ | Korvataan työkopion päivitysversiovälillä. Jos työkopio on yhtenäinen, tuloksena on yksi versio. Jos työkopio sisältää eri versioita (johtuen siitä, että se ei ole ajan tasalla, tai päivitä-versioon -komennosta), niin versioväli näytetään muodossa 100:200. |
$WCMIXED$ | $WCMIXED?TText:FText$ korvataan muodolla TText mikäli työkopiossa on useita versioita, tai muodolla FText jos näin ei ole. |
$WCMODS$ | $WCMODS?TText:FText$ korvataan muodolla TText jos työkopiossa on paikallisia muutoksia, tai muodolla FText jos näin ei ole. |
$WCUNVER$ | $WCUNVER?TText:FText$ korvataan muodolla TText mikäli työkopiossa on versioimattomia tiedostoja, tai muodolla FText jos näin ei ole. |
$WCEXTALLFIXED$ | $WCEXTALLFIXED?TText:FText$ korvataan tekstillä TText mikäli kaikki ulkoiset viitteet on sidottu kiinteään versioon, tai tekstillä FText mikäli näin ei ole. |
$WCISTAGGED$ | $WCISTAGGED?TText:FText$ korvataan tekstillä TText mikäli arkistopaikannin viittaa merkittyyn versioon, tai tekstillä FText jos näin ei ole. |
$WCURL$ | Korvataan sen arkiston paikantimella, josta tiedoston työkopio on peräisin. |
$WCINSVN$ | $WCINSVN?TText:FText$ korvataan tekstillä TText mikäli alkio on versioitu, tai tekstillä FText jos näin ei ole. |
$WCNEEDSLOCK$ | $WCNEEDSLOCK?TText:FText$ korvataan tekstillä TText jos alkion svn:needs-lock -ominaisuus on asetettu, tai tekstillä FText jos näin ei ole. |
$WCISLOCKED$ | $WCISLOCKED?TText:FText$ korvataan tekstillä TText jos alkio on lukittu, tai tekstillä FText jos näin ei ole. |
$WCLOCKDATE$, $WCLOCKDATEUTC$ | Korvataan lukituspäiväyksellä. Ajan esitystä voidaan käyttää kuten $WCDATE$ yhteydessä. |
$WCLOCKOWNER$ | Korvataan lukon omistajan nimellä. |
$WCLOCKCOMMENT$ | Korvataan lukituskommentilla. |
$WCUNVER$ | $WCUNVER?TText:FText$ korvataan muodolla TText mikäli työkopiossa on versioimattomia tiedostoja/kansioita, tai muodolla FText jos näin ei ole. |
SubWCRev ei suoraan tue sisäkkäisä lausekkeita, joten et voi käyttää esimerkiksi seuraavaa lauseketta:
#define SVN_REVISION "$WCMIXED?$WCRANGE$:$WCREV$$"
Voit kuitenkin yleensä kiertää rajoituksen esimerkiksi seuraavalla tavalla:
#define SVN_RANGE $WCRANGE$ #define SVN_REV $WCREV$ #define SVN_REVISION "$WCMIXED?SVN_RANGE:SVN_REV$"
Jotkin näistä avainsanoista koskevat hakemistojen sijaan yksittäisiä tiedostoja, joten niiden käyttö on järkevää vain, kun SubWCRev käy läpi yksittäisen tiedoston. Tämä pätee avainsanoihin $WCINSVN$
, $WCNEEDSLOCK$
, $WCISLOCKED$
, $WCLOCKDATE$
, $WCLOCKOWNER$
ja $WCLOCKCOMMENT$
.