
         ---------------------------
        | Kephra Funktionsbersicht |
         ---------------------------

Auch wenn der Editor noch nicht alles vermag, was wir gerne htten, so mchten
wir ihn mchtig nennen weil diese Liste lang ist. Wenn euch Texteditoren bereits
vertraut sind, kann vieles hier bersprungen werden. Dann empfehle ich die
'besondere_funktionen.txt' zu lesen, die im Men auch unter Hilfe > Ntzliches
zu findet ist.

Sollte euch eine volltndige, thematisch nach dem Hauptmen sortierte bersicht 
der Funktionen dennoch interessieren, so schreitet weiter. Alle Config-Schlssel 
beziehen sich auf die Datei "config/general/autosaved.conf" (Haupteinstellungen).



Inhalt:

 1 im Text Navigieren
 2 Text Markieren 
 3 Textbearbeitung (Bearbeiten Men)
 4 History (Bearbeiten Men)
 5 Zwischenablage (Bearbeiten Men)
 6 Suchen-Men und Suchen-Dialog
 7 Datei-Men
 8 Dokument-Men
 9 Ansicht-Men
 10 Konfgurations-Men:
 11 Hilfe-Men:



 1 Im Text Navigieren - Caret Bewegen
   - Richtungstasten (Tasten mit den Pfeilen drauf) oder ein Links-Klick an die
     entsprechende Position mit der Maus bewegt den Caret (Textcursor)
   - <Pos1> Taste bewegt den Caret zum ersten Zeichen der aktuellen Zeile, das 
     kein Leerzeichen ist. Drckt man nochmal <Pos1> steht der Caret am 
     Zeilenanfang. Die <Ende>-Taste bewegt Caret zum letzten Zeichen der Zeile.
   - <Strg>+<Pos1> springt zum Anfang des Textes und <Strg>+<Ende> zum letzten 
     Zeichen der letzten Zeile
   - <Bild hoch> und <Bild runter> bewegen den Caret seitenweise wobei eine
     Seite dem sichtbaren Textfenster entspricht
   - <Strg>+<Bild hoch> oder <Bild runter> whlen das vorige oder nchste 
     Dokument an. Das zuletzt benutzte Dokument wird mit <Strg>+<Enter> oder einem
     Klick auf das aktuelle Tab angewhlt.
   - <Strg>+<Links> oder <Rechts> (Pfeiltasten) lsst den Caret wortweise springen
   - <Strg>+<Hoch> oder <Runter> scrollt zeilenweise
   - <Alt>+<Hoch> oder <Runter> blttert absatzweise (Abstze werden durch leere
     Zeilen getrennt)
   - Wenn man weiss in welche Zeile man mchte hilft auch <Strg>+<G>.
   - Mit <Strg>+<+> oder <-> kann man den Text auch zoomen lassen

 2 Text Markieren
   - Hlt man <Shift> oder linke Maus-Taste gedrckt wird Text markiert (ausgewhlt)
   - Um einen rechteckigen Bereich auszuwhlen, hlt man dabei Alt gedrckt.
   - Markierten Text kann man entweder durch gedrckt-halten der linken Maustaste
     mit der Maus verschieben oder durch gedrckt-halten von <Strg>+<Alt> mit den
     Richtungstasten verschieben. Ist nichts markiert verschiebt <Strg>+<Alt>+<Hoch>
     oder <Runter> die aktuelle Zeile.
   - Hlt man Strg gedrckt, verschiebt man mit der Maus eine Kopie des markierten
     Textes.
   - <Strg>+<A> markiert den gesamten Text

 3 Textbearbeitung (Bearbeiten Men)
   Meist whlt man durch markieren einen Text aus um diesen speziell zu bearbeiten.
   Ist kein Text ausgewhlt nehmen viele pce-Funktionen das gesamte Dokument.
   Das Hinzunehmen der <Shift> Taste kehrt die Bedeutung einer Tastenkombination
   meistens um.
   - Gibt man Text ein whrend noch etwas markiert ist wird das Markierte gelscht.
   - <Einfg> lsst die Caret-Form wechseln. Steht er senkrecht wird der eingegebene
     Text eingefgt, ist er waagerecht, wird der vorhandene Text berschrieben.
   - <Entf> lscht das Zeichen rechts neben dem Caret, <Strg>+<Entf> das ganze
     Wort rechts neben dem Caret. Die <Rck>-Taste (<--) lscht das Zeichen links 
     neben dem Zeiger, <Strg>+<Rck> wieder das ganze Wort.
   - Es gibt 3 Gruppen mit Funktionen zur Textbearbeitung mit gleichnamigen
     Untermens im Men Bearbeiten(unten). Formatieren bedeutet dabei in eine
     andere Form bringen, konvertieren den Text umzuwandeln und kommentieren ihn
     je nach Sprache zu de/aktivieren.
   - <Strg>+<Leertaste> rckt die aktuelle Zeile ein, bewegt sie 1 Zeichen nach
     rechts. Dies geschieht unabhngig von der Caretposition und kann durch
     markieren auch auf mehrere Zeilen zugleich angewendet werden.
     <Strg>+<Shift>+<Leertaste> rckt ensprechend auch. (1 Zeichen nach links)
   - Verwendet man dabei statt der Leertaste die <Tab>-Taste (|<- ->|) rckt man
     die Zeile(n) mehrere Zeichen aus einmal ein oder aus. Wieviel Zeichen hngt
     von den aktuell eingestellten Lnge eines Tabulators ab.
   - ber das Hauptmen kann man auch mehrere Zeilen gleichtief einrcken lassen
     (an erster Zeile ausrichten), Zeilen verbinden und abstehende Leerzeichen
     entfernen. (Leerzeichen nach denen kein Schriftzeichen mehr in der Zeile
     folgt)

 5 History (Bearbeiten Men)
   - der Editor merkt sich jede nderung so das man mit <Strg>+<Z> beliebig viele
     nderungen zurcknehmen kann, sozusagen rckwrts in der Geschichte der
     nderungen geht.
   - Wenn man nur mal nachschauen wollte und wieder "vorwrts" gehen will kann
     man die "rckwrts-Schritte" mit <Strg>+<Shift>+<Z> zurcknehmen. Allerdings
     ist der Weg "vorwrts" versperrt sobald man in der Vergangenheit eine
     nderung unternimmt. (es wre ja nicht merh die gleiche Zukunft).
   - Nimmt man dabei die <Alt>-Taste hinzu kann man die Sprnge beschleunigen,
     denn dabei werden mehrere Schritte aus einmal gesprungen. Die genaue Anzahl
     kann man in der config unter editpanel > history festlegen.
   - <Strg>+<Alt>+<Z> macht alle nderungen rckgngig und <Strg>+<Alt>+<Shift>+<Z>
     lsst sofort wieder zum aktuellen Stand zurckkehren.

 4 Zwischenablage (Bearbeiten Men)
   Jeder neuere Desktop oder Betriebssystem hat einen Speicher wo Programme Daten
   ablegen und wieder aufnehmen knnen. Damit kann man auch Texte zwischen den
   Programmen austauschen aber auch nur "zwischenparken" um sie spter wieder
   mit dem gleichen Programm weiterzuverwenden.
   - <Strg>+<C> oder ein Klick auf das Kopieren-Icon in der Toolbar, Hauptmen >
     Bearbeiten oder im Kontextmen kopiert den markierten Text in die
     Zwischenablage.
   - <Strg>+<V> (oder Einfgen) fgt den Text der Zwischenablage an der Stelle
     in das Dokument ein, an dem sich der Caret befindet. Der dabei markierte 
     Text wird berschrieben.
   - <Strg>+<W> (oder Tauschen) tauscht den markierten Text mit dem in der 
      Zwischenablage.
   - <Strg>+<X> (oder Auschneiden) entfernt den markierten Text und kopiert ihn 
     in die Zwischenablage.
   - <Entf> (oder Entfernen) lscht ohne zu kopieren.
   - Ausschneiden, Kopieren und Lschen kann man auch auf die aktuelle Zeile
     anwenden wenn man die Shift Taste hinzunimmt.
   - <Strg>+<Shift>+<L> oder <R> lschen die aktuelle Zeile links oder rechts des 
     Carets
   - <Strg>+<Shift>+<D> doppelt die aktuelle Zeile.
   - Eigentlich knnt man aber auch Texte per DND (markieren, anklicken + linke
     Taste gedrckt lassen, zum ziel ziehen und loslassen) auch in andere
     Programme verschieben. Gedrckt-lassen der <Strg> bewirkt das nur eine Kopie
     verschoben wird.

 6 Suchen-Men und Suchen-Dialog
   Der Editor kann das aktuelle Dokument, alle offenen Dokumente oder nur 
   innerhalb einer Markierung nach einem bestimmten Text suchen. Das geht
   mit oder auch ohne den Suchdialog, aber Suchoptionen lassen sich nur ber den
   Dialog verndern (oder ber die config, auch wenn das kein eleganter Weg ist.)
   - <Strg>+<F> ffnet den Suchdialog. Er erwartet die Eingabe des zu suchenden 
     Textes. Bereits verwendete Suchbegriffe knnen mit den Richtungstasten 
     <Hoch> und <Runter> angefordert werden.
   - Hat man vorher einen Text markiert, wird dieser automatisch als 
     Suchbegriff eingefgt. Ging die Markierung aber ber mehrere Zeilen, 
     erkennt er dies als Suchbereich an. 
     Man beachte dass man bei einer  Suche in einem markierten Bereich nur den 
     ersten Fund anzeigen kann und die ursprngliche Markierung dann weg ist.
   - Drckt man nach Eingabe des Suchbegriffes <Enter>, beginnt die Suche von 
     oben nach unten. Hlt man dabei <Shift> gedrckt sucht er "rckwrts" von 
     unten nach oben. Ein gehaltenes <Strg> beendet den Dialog nach der Suche.
   - Zum vorwrts und rckwrts suchen gibt es auch 2 Icons in der Toolbar 
     (Lupe mit Pfeilen) die eine Navigation per Maus ermglichen. Im Suchdialog 
     befindet sich ganz rechts mehrere Knpfe die ebenfalls eine Bedienung per 
     Maus ermglichen.
     Dieses Such Pad ermglicht auch schnelle Suche sowie Springen zum ersten 
     und untersten Fund sowie vorwrts und rckwrts suchen mit ersetzen.
   - Unterhalb der Suchbereich-Auswahl ist die Checkbox "Springe zw. Enden".
     Ist sie aktiviert findet der Editor am Dokumentende als nchsten Fund
     den obersten oder springt auch vom obersten rckwrts wieder zum letzten
     Fund, wenn man dessen Vorgnger sucht.
   - Ist die Option inkrementelle Suche aktiviert, wird mit jeder Vernderung 
     der neue Suchbegriff vom Dokumentanfang beginnend gesucht.
   - Suchoptionen: 
      + Gross/klein-schreibung des Suchbegriffes (nicht)beachten.
      + der Suchbegriff muss (nicht) Anfang eines Wortes sein. 
      + der Suchbegriff muss (nicht) ganzes Wortes sein.
      + der Suchbegriff kann durch einfache regulre Ausdrcke gebildet werden.
   - Wenn man ohne Dialog Suchen mchte kann man sich mit <F3> vorwrts suchen
     und rckwrts mit <Shift>+<F3>. <Strg>+<Alt>+<F3> springt zum obersten und 
     <Shift>+<Strg>+<Alt>+<F3> zum letzten Fund. Der "Suchen"-Knopf in der 
     untersten Zeile des Dialogs entspricht <Strg>+<Alt>+<F3>. Mchte man einen 
     neuen Suchbegriff ohne Dialog definieren, markiert man ihn im Text 
     und drckt <Strg>+<F3>.
   - Wenn man den Dialog mit <Shift>+<Strg>+<F> ruft, erwartet er den Text mit 
     dem ersetzt werden kann. Der letzte Suchbegriff wird automatisch eingesetzt.
     Entsprechend dem Suchverhalten wird hier auch ein etwaiger markierter Text
     als Ersetzen-Begriff eingesetzt, geht die Markierung ber mehrere Zeilen
     wird die als Suchbereich verstanden. Auch diese Eingabezeile ermglicht mit
     den vertikalen Pfeiltastet oder mit der Maus in den letztbenutzen Begriffen
     zu blttern.
   - Drckt man <Enter> wird sofort im angegeben Suchbereich alles ersetzt, was
     dem Knopf "Alle Ersetzen" in der untersten Zeile entspricht. Hlt man dabei
     <Strg> gedrckt, wird der Dialog nach dem Ersetzen geschlossen. Hlt man 
     dabei jedoch <Alt> gedrckt entspricht das der Funktion des Knopfes 
     "Mit Besttigung". Dabei wird vor jedem Ersetzen nachgefragt ob dieses 
     Ersetzen erwnscht ist.
   - Die andere Mglichkeit dies zu erreichen ist das bereits erwhnte Searchpad
     im rechten Drittel des Dialogs.
   - Der Dialog kann mit der <Esc>-Taste oder dem "Schliessen"-Knopf beendet 
     werden.
   -"Gehe zu Zeile" oder <Strg>+<G> ruft einen Dialog mit dem man zu einer
     angegeben Zeilennummer im aktuellen Dokument springen kann.

 7 Datei-Men
   Enthlt alle Funktionen die auf die Festplatte zugreifen, einzige Ausnahmen 
   sind "neu" und "beenden" die aber noch am ehesesten hierher gehren.
   - "neu" erstellt neues leeres Dokument das noch keinem Dateinamen zugeordnet 
     ist.
   - "ffnen" liest eine Datei ein und fgt den Inhalt in ein neues Dokument.
     der Dateiname bleibt dem Dokument zugeordnet.
   - "neu einlesen" Liest die einem Dokument zugeordnete Datei erneut ein und 
     ersetzt den Text des Dokumentes mit dem Inhalt der Datei. Dadurch wird die 
     letzte gespeicherte Version wiederhergestellt.
   - "einfgen" fgt den Inhalt einer ausgewhlten Datei am aktuellen Textcursor
     (caret) ein.
   - "speichern" sichert den aktuell sichtbaren Text in der zugehrigen Datei.
   - "speichern unter" speichert den Text unter einem ausgewhlten Dateinamen,
     der nun dem Dokument zugeordnet wird.
   - "kopie speichern" speichert auch den Text unter einem ausgewhlten Dateinamen,
     allerding bleibt das Dokument dem vorigen Dateinamen zugeordnet.
   - "alle/anderen" Alle beziet sich immer auf alle offenen Dateien und anderen
     auf alle ausser der aktuellen Datei.
   - "Gruppe" meint die Zusammenfassung aller zu einem Zeitpunkt geffneten
     Dokumente. Die in dem Untermen gezeigten Funktionen dienen dem Speichern
     aller BER die Dokument-Gruppe bekannten Informationen, die auch spter mit
     ffnen oder hinzufgen wieder hergestellt werden knnen. Da andere Editoren
     andere Formate benutzen solche Gruppen zu speichern bietet der Editor
     auch die Mglichkeit an, diese zu importieren oder zu exportieren.

 8 Dokument-Einstellungen
   sind (meistens) Eigenschaften die fr jedes Dokument getrennt gespeichert und
   verndert werden knnen. Das Meiste davon verstellt man ber das Dokument-Men
   oder direkt in der Haupkonfigurationsdatei: "config/general/autosaved.conf" .
   Syntaxstyle und Tabmode lassen sich aber auch ber die Statuszeile verstellen.
   - Das Syntaxstyle bestimmt die Einfrbung des Textes und entspricht der
     Grammatik der jewailigen Sprache. Die Auswahl des Styles erfolgt meist beim
     ffnen der Datei automatisch anhand der Datei-Endung. Die Zugehrigkeit
     eines Styles zu einer Endung definieren die file > endings Einstellungen in
     der config.
   - Klammerhervorhebung lsst zugehriges Klammerpaare aufleuchten und zeigt
     auch an wenn die Klammer keinen Partner hat. Die Farbeinstellungen dazu sind
     unter editpanel > indicator > bracelight. Diese Eigenschaft ist derzeit
     nur global an und abschaltbar.
   - Klammereinrckung(block indent) bedeutet dass ein <Enter> nach ffnenden
     Klammern einrcken lsst und nach schliessenden Klammern ausrcken lsst.
     siehe editpanel > blockindent. Dort finden sich auch die Schlssel
     brace_autojoin und brace_automake mit die den Editor veranlassen bei
     blockindent gleich die zugehrige Klammer zu erzeugen bzw. bei blockdedent
     eventuell dann doppelt vorhandene schliesende Klammern zu lschen.
   - Autoeinrckung(autoindent) lsst jede neue Zeile sofort so weit einrcken
     wie die Vorige. Diese Eigenschaft ist derzeit, wie auch Klammereinrckung,
     nur global an und abschaltbar.
   - Tabs sind nicht sichtbare Zeichen die zum Formatieren des Textes dienen und
     die den Platz mehrere Leerzeichen einnehmen knnen. Wie viele dies sind kann
     man unter Tab Breite einstellen. der Wert dafr in neuen Dateien richtet
     sich nach der config Einstellung in file > defaultsetting > tab_size.
   - Soft Tabs nennt man entsprechend viele Leerzeichen die anstatt
     eines Tabs eingefgt werden wenn die Tab-Taste(|<-- -->|) gedrckt wird.
     Siehe Men tabulatoren und config: file > defaultsetting > tab_use.
   - EOL: Windows, Unix(Linux) und Mac benutzen verschiedene Zeilentrennzeichen.
     der Editor erkennt nicht nur alle sondern erzeugt standardmssig auch die
     jeweils in dem Dokument verwendeten EOL's. Man kann jedoch auch in der
     config: file > defaultsetting > EOL_open von auto auf cr|lf|cr+lf stellen.
     Dann werden geffnete Dateien automatisch konvertiert.
     file > defaultsetting > EOL_new bestimmt den EOL neuer Dokumente.
   - Schreibschutz. Manche Dateien drfen vom Benutzer nich geschrieben werden.
     um sptere Konflikte zu vermeiden werden die ensprechenden Dokumente mit
     einer Raute im Reiter gekennzeichnet und knnen nicht im Editor bearbeitet
     werden. Der Schreibschutz ist aber ber das Men an und abschaltbar.

 9 Ansicht-Einstellungen
   ndern nichts am Text sondern nur an der Optik des Textes oder des Programmes.
   Sie gelten fr alle Dokumente in gleicher Weise.
   - "Im Vordergrund" ist er mit <Strg>+<T> aktiviert berlagert der Editor jedes
     andere Fenster und bleibt stndig sichtbar.
   - "Symbolleiste"-"Statuskontext" Dieser Block im Ansichtmen dient zum Ein- 
     und Ausblenden von Teilen der Programmoberflche. Alle Einstellungen 
     unterhalb beziehen sich auf das Textfeld.
   - "Zeilennummern" bestimmt die Breite der Anzeige der Zeilennummern. Diese 
     passt sich den Bedrfnissen an, solange die Breite nicht 0 ist oder 
     config: editpanel > margin > linenumber > autosize aktiv ist. Auch Farben 
     und Mindestbreite knnen dort eingestellt werden.
   - "Extrarand": Damit kann ein zustzlicher Abstand an den Rndern des
     Textfeldes links und rechts eingestellt werden.
   - "Rechter Rand" blendet eine senkrechte Linie ein oder aus, an der man die 
      Zeilenenden ausrichten kann. Farbe und Position sind in der Config-Datei
      unter editpanel > indicator > right_margin gespeichert.
   - "Einrckmarkierung" blendet auch senkrechte Linien ein/aus, an denen man 
      die Einrckungen der Zeilen orientieren kann. Diese Linien erscheinen
      nur dort wo Leerzeichen sind, in Abstnden, die der aktuellen 
      Tabulatorbreite entsprechen.
   - "Aktuelle Zeile" markiert die Zeile in der sich der Caret befindet mit 
      einer besonderen Hintergrundfarbe. (editpanel > indicator > caret_line)
   - "Zeilenumbruch" bricht Zeilen am Fensterrand um, und stellt lange Zeilen in 
      mehreren Teilen untereinander dar.
   - "Zeilenendsymbol" blendet Symbole fr die sonst unsichtbaren Zeilentrenn-
     zeichen ein oder aus.
   - "Leerzeichen" mache Leerzeichen und Tabulatoren mit Punkten und Pfeilen
      sichtbar oder unsichtbar.
   - "Schriftart" ruft einen Dialog mit dem man alle Eigenschaften der 
     verwendeten Schriftart einstellen kann.

 10 Konfgurations-Men:
    Ist eine bersicht ber alle Konfigurtaions-Dateien die hier schnell geffnet
    oder geladen werden knnen.
   
 11 Hilfe-Men:
    Texte mit Informationen ber das Programm. Soll angeblich die Benutzung 
    erleichtern.