Merge 88ff580 into a803f0e

doc/manual/de/colab/index.rst

@@ -87,6 +87,10 @@ zu vermischen. In einen anderen Branch wechseln kann man immer nach einem commit
 
 Repositories synchron halten
 ----------------------------
+
+Über github.com
+^^^^^^^^^^^^^^^
+
 Um die von anderen Entwicklern *gemergeden* Änderungen mit dem eigenen Fork synchron zu halten, muss ein Pull-Request  
 vom privaten Repository aus gemacht werden. In der Zeile *This branch is ... commits ahead of CometVisu:develop.* zeigt 
 an, wieviele Änderungen seit der letzten Synchronisierung vorgenommen wurden. Direkt daneben befindet sich der Link zum *Pull Request*, 
@@ -121,12 +125,76 @@ Das Akzeptieren aller Änderungen synchronisiert die Änderungen vom Haupt-Repos
 Die lokale Kopie des privaten Repositories muss dann ebenso aktualisiert werden. Dazu muss im lokalen Repository in den Branch 
 *develop* gewechselt werden (``git checkout develop``), dort werden alle abgestimmten Änderungen der Entwickler *gemerged*.
 Mit dem Befehl ``git pull`` erfolgt die Synchronisation zwischen lokalem und privatem Repository. Nachdem nun alle Repositories 
-wieder synchron sind, kann wie oben unter 1. beschrieben mit neuen Änderungen an der Dokumentation fortgefahren werden. 
+wieder synchron sind, kann wie oben unter 1. beschrieben mit neuen Änderungen an der Dokumentation fortgefahren werden.
+
+
+Über die Kommandozeile
+^^^^^^^^^^^^^^^^^^^^^^
+
+Natürlich kann man den lokalen Klon seines Repositories auch rein über Kommandozeilenbefehle komfortabel synchron halten.
+Um dieses möglichst einfach zu machen, muss man die *Remotes* seines lokalen Klons entsprechend konfigurieren.
+
+.. HINT::
+    Für die folgenden Beispiele wird angenommen, dass man den Usernamen ``gh-user`` hat und das CometVisu Repository über SSH
+    geklont hat (``git clone git@github.com:gh-user/CometVisu.git``). Wenn man über HTTPS geklont hat
+    (``https://github.com/CometVisu/CometVisu.git``) sehen die URLs entsprechend anders aus.
+
+Zusammenfassung
+"""""""""""""""
+
+.. code-block:: bash
+
+    # aktuelle Einstellungen abfragen
+    git remote -v
+    >>> origin	git@github.com:gh-user/CometVisu.git (fetch)
+    >>> origin	git@github.com:gh-user/CometVisu.git (push)
+
+    # Aktualisierungen vom original Repository holen
+    git remote set-url origin git@github.com:CometVisu/CometVisu.git
+
+    # aktuelle Einstellungen prüfen
+    git remote -v
+    >>> origin	git@github.com:CometVisu/CometVisu.git (fetch)
+    >>> origin	git@github.com:gh-user/CometVisu.git (push)
+
+    # develop branch mit original Repository synchronisieren
+    git checkout develop
+    git pull
+
+Ausführliche Vorgehensweise
+"""""""""""""""""""""""""""
+
+Die aktuellen Einstellungen kann man mit dem Befehl ``git remote -v`` abfragen.
+Üblicherweise liefert das folgende Werte:
+
+.. code-block:: bash
+
+    origin	git@github.com:gh-user/CometVisu.git (fetch)
+    origin	git@github.com:gh-user/CometVisu.git (push)
+
+Das bedeuted, dass git beim Aktualisieren (*fetch*, *pull*) und auch beim *pushen* den Fork des Users auf github benutzt.
+Man möchte nun aber möglichst einfach Änderungen auf dem Haupt-Repository in den lokalen Klon laden. Dazu ändert man die
+*fetch* URL des remotes mit folgendem Befehl: ``git remote set-url origin git@github.com:CometVisu/CometVisu.git``.
+Danach sollte ``git remote -v`` folgende Ausgabe liefern:
+
+.. code-block:: bash
+
+    origin	git@github.com:CometVisu/CometVisu.git (fetch)
+    origin	git@github.com:gh-user/CometVisu.git (push)
+
+Damit sind die Vorraussetzungen erfüllt und man kann seinen lokalen *develop* Branch (dieser enthält die neuesten Weiterenwicklungen)
+ganz einfach durch ein ``git pull`` aktualisieren.
+
+.. HINT::
+    Diese Vorgehensweise ist nur ratsam, wenn man nur an einem Rechner Änderungen an der CometVisu vornimmt.
+    Wenn man gleichzeitig mehrere Rechner benutzt, muss man zwangsläufig die Änderungen die man von dem anderen Rechner
+    in den eigenen Fork *gepushed* hat in den lokalen Klon bekommen. Dazu kann man ein zweites Remote einrichten mit
+    ``git remote add fork git@github.com:gh-user/CometVisu.git`` und dann davon *pullen*
+    ``git pull fork develop``
 
 .. TODO::
 
     * weitere nützliche Git-Befehle (branches löschen, status, ...)
-    * Eigenen Fork vom Haupt-Repository aktualisieren
     * Merge-Konflikte
     * Ablauf-Diagramm für Workflow Änderung -> Pull-Request
 

src/lib/CometVisuClient.js

@@ -470,6 +470,10 @@ define( ['jquery'], function( $ ) {
       return new CometVisuClient();
     }
 
+    this.setInitialAddresses = function(addresses) {
+      this.initialAddresses = addresses;
+    }
+
     /**
      * manipulates the header of the current ajax query before it is been send to the server
      */