This translation is incomplete. Please help translate this article from English.

 

Note: Dacă nu ai citit Mercurial de bază citeste acum, sau vezi Mercurial pentru alte resurse.

Vă rugăm folosiți Mercurial For Mozillians at ReadTheDocs pentru cele mai bune practici despre Mercurial, inclusiv multe instrumente ajutătoare și instrucțiuni care fac folosirea a lui Mercurial repede și usor .

Instalarea

Vezi Instalând Mercurial de la ghidul Mozilla Version.

Configurații de bază

Ar trebui să configurezi Mercurial înainte să trimiți patche-uri la Mozilla.

Dacă o să iei codul sursă Firefox sau un repozitoriu derivat, cea mai usoară metoda de a configura Mercurial este de a rula comanda mach mercurial-setup:

./mach mercurial-setup

Aceasta comanda pornește un wizard interactiv care de va ajuta să stabilească că Mercurial este configurat cu ultimele setări recomandate. Această comandă nu va schimba nici o filă pe calculatorul dumneavoastră fară permisiune.

Dacă nu aveți codul sursă Firefox valabil, ar trebui să editați fișierul configurația Mercurial să arate astfel:

[ui]
username = Your Real Name <user@example.com>
merge = your-merge-program (or internal:merge)
 
[diff]
git = 1
showfunc = 1
unified = 8

[defaults]
commit = -v

Pe Windows, setările pot fi adăugate la $HOME\.hgrc or $HOME\Mercurial.ini, sau, dacă preferați setările globale, C:\mozilla-build\hg\Mercurial.ini sau C:\Program Files\Mercurial\Mercurial.ini. Pe sisteme asemănătoare lui UNIX , ar trebui să fie in fișierul $HOME/.hgrc .

Puteți să configurați editorul de folosit pentru mesaje de comitere folosind opțiunea editor în secțiunea [ui] sau setând varabila de sistem EDITOR .

Dacă încercați să obțineți să accesați repozitoriul printr-un server proxy, citiți aceste instructuni.

Alte sfaturi de configurație

Îmbină programul

După instalare, alege merge program. Pe bune. Acum. Dacă nu Mercurial va alege unul pentru tine și îț va dezlănțui când de astepți mai puțin.

Un lucru rezonabil de făcut este de a seta ui.merge=internal:merge în fișierul de configurație Mercurial (vezi mai jos), care face Mercurial să încerce de îmbinare a schimbărilor și să adauge marcaje de conflict  (ca CVS) fișierelor care nu au putut să fie îmbinate.

Sub Ubuntu, poți instala pachetul meld, după care in fișierul de configurare Mercurial (vezi mai jos) setează ui.merge=meld

Poți vedea lista de conflicte căutând "merging ... failed!" în rezultatul actualizării.

Configurarea kdiff3 ca un instrument de îmbinare

Dacă ești pe Linux și ai kdiff3 installat, probabil vrei să configurezi kdiff3 ca un instrument de îmbinare.  (Este mai bun decât meld pentru că va rezolva o grămadă de conflicte fară să îți dea vreun prompt.)  Poți să faci asta prin adăugarea următoarelor lini (care vin de la contrib/mergetools.hgrc în descripția Mercurial):

[merge-tools]
kdiff3.args=--auto -L1 base --L2 local --L3 other $base $local $other -o $output
kdiff3.regkey=Software\KDiff3
kdiff3.regappend=\kdiff3.exe
kdiff3.fixeol=True
kdiff3.gui=True

Extensi

Există un număr de extensi ce pot să fie activate. Vezi http://mercurial.selenic.com/wiki/UsingExtensions. Aproape toată lumea ar trebui să aibă active următoarele:

  • color - Colorează rezultatul terminalului.
  • histedit - Oferă comportament git rebase --interactive .
  • pager - Trimite rezultatul comenzi intr-un pager (precum less).
  • progress - Desenează o bară de progres în operațile de lungă durată.
  • rebase - Abilitatea de a rebaza patche-uri ușor între repozitorii, ramuri, etc.
  • transplant - Abilitatea de a muta patche-uri ușor între repozitorii, ramuri, etc.

Acestea se pot activa prin adăua acestea la fisșierul .hgrc:

[extensions]
color = 
rebase =
histedit =
progress =
transplant =
pager =

În adiție, există niște extensi exterioare care sunt foarte folositoare pentru programare de bază:

mozext
Functionalitate specifică Mozilla să ajute în programarea Firefox/Gecko.
trychooser
Automatic crează un încearcă mesaj de comitere și împinge schimbarile spre Mozilla. Încearcă infrastructure. Doar ruleazaă:
hg trychooser
qimportbz
Importează patche-uri de la Bugzilla. Crează un nume de fișier și mesaj de comitere pentru dine în metadata bugului.
hg qimport bz://1234567
  
bzexport
Exportează patche-uri la Bugzilla. Există câteva argumente opționale de a crea noi buguri sau buguri actualizați cu attment, și de asemenea cere automat revizuiri. Scrie hg help bzexport pentru o listă completă cu sintaxă de bază:
hg bzexport -i 1234567

Instalândule este destul de ușor. Tot ce trebuie să faci este să găsești un loc de depozitare a extensilor și să clonezi repozitoarele extensilor în el:

hg clone https://bitbucket.org/edgimar/crecord
hg clone https://bitbucket.org/sfink/mqext
hg clone https://hg.mozilla.org/users/robarnold_cmu.edu/qimportbz
git clone https://github.com/pbiggar/trychooser

Si după aceea să adaugi în fișierul .hgrc 

[extensions]
qcrecord =  /path/to/crecord/crecord
mqext =  path/to/mqext
qimportbz =  path/to/qimportbz
trychooser = path/to/trychooser/trychooser

Configurare repozitorului try

Dacă ai acces la un try server ai putea dori să configurezi Mercurial ca să poți să îl referi simplu ca try, findcă îți poate fi folositor pe mai multe ramuri.Aceasta se poate face adăugând următoarele la ~/.hgrc (sau Mercurial.ini):

 

[paths]
try = ssh://hg.mozilla.org/try/

Poți configura nume scurte care sunt specifice la anume repozitorii prin adăugarea unei scțiuni [paths] la fila .hg/hgrc file din repozitoriu.  Există două nume magice, "default" și"default-push", care sun folosite ca ținte pentru push/pull în modul implicit.  (Dacă "modul implicit" este specificat și "default-push" nu, "default" este folosit pentru amândouă.)

Alternativ, poți instala trychooser extension (versiuni mai vechi).

 

Document Tags and Contributors

Contributors to this page: VladPavel15
Last updated by: VladPavel15,