.. -*- coding: utf-8 -*-












.. role:: sref(numref)
.. role:: xref(numref)
.. Copyright (C) 2014, 2020, Wolfgang Scherer, <Wolfgang.Scherer at gmx.de>

.. This file is part of Documentation Standard.

.. Permission is granted to copy, distribute and/or modify this document
.. under the terms of the GNU Free Documentation License, Version 1.3
.. or any later version published by the Free Software Foundation;
.. with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
.. A copy of the license is included in the section entitled "GNU
.. Free Documentation License".

.. inline comments (with du_comment_role)
.. role:: rem(comment)
.. role:: html(raw)
   :format: html
.. role:: shx(code)
   :language: sh

.. rst-class:: xnarrow xmedium large xhuge xultra

##################################################
:rem:`|||:sec:|||`\ VCS - Mercurial
##################################################
.. >>CODD See `the components of a doctoral dissertation and their order <http://site.uit.no/english/writing-style/bookstructure/>`_
.. >>CODD Dedication
.. >>CODD Epigraph
.. >>CODD Abstract
.. compound::

   .. \|:here:|

.. >>CODD Introduction
.. >>CODD Chapter

==================================================
:rem:`|||:sec:|||`\ Repository Manipulation
==================================================

Check out `graft`, `transpose`.

--------------------------------------------------
:rem:`||:sec:||`\ convert
--------------------------------------------------

Make sure, that there are no modifications in source repository::

    hg -R /home/ws/project/ws_rfid/demo status -q

Get filemap of active files::

    hg -R /home/ws/project/ws_rfid/demo status -c | sed 's,^C,include,' >filemap.txt

Convert source repo to new repo without deleted files::

    hg convert --filemap filemap.txt /home/ws/project/ws_rfid/demo demo

Update new repo::

    ( cd demo && hg update -C )

::

    dest_repo="adhoc-c"
    rm -rf "${dest_repo}"
    cat <<'EOF' >filemap
    include "adhoc"
    rename "adhoc" "."
    EOF
    hg convert --filemap filemap /home/ws/project/ws-util "${dest_repo}"
    (
    cd "${dest_repo}" || exit 1
    hg update -C
    )

-------------------------------------------------------
:rem:`||:sec:||`\ Remove unwanted branches, clone --rev
-------------------------------------------------------

Remove unwanted branches::

    hg clone --rev xxx URL

Also copy .hg/hgrc!

.. >>CODD Conclusion
.. >>CODD Appendix A

.. \|:here:|

.. >>CODD Notes
.. ==================================================
.. :rem:`|||:sec:|||`\ Footnotes
.. ==================================================

:html:`<hr>`

.. \[#]

.. \|:info:| put local references here
.. \|:info:| put local definitions here
.. include:: doc_defs.inc
.. include:: abbrev_defs.inc
.. include:: doc_defs_combined.inc
..
  .. \||<-snap->|| doc_standalone
  .. include:: doc/doc_defs_secret.inc
  .. \||<-snap->|| doc_standalone
  .. \||<-snap->|| not_doc_standalone
  .. include:: doc_defs_secret.inc
  .. \||<-snap->|| not_doc_standalone

.. _`Wolfgang Scherer`: wolfgang.scherer@gmx.de