======================================================================
              TEdit / TE (Text Editor) - User Manual                     
======================================================================
Version: 2.7.0
Created by: alby13

Welcome to TE! This is a fast, terminal-based text editor built with
Python and Curses. It features syntax highlighting, full mouse support, 
clipboard integration, interactive menus, and visual customization.

This manual covers everything you need to know to use the editor.

----------------------------------------------------------------------
1. MODES OF OPERATION
----------------------------------------------------------------------
* EDIT MODE 
  The default state. Type to insert text, use arrow keys to move 
  the cursor, and edit your document freely.

* MENU MODE 
  Press [F9] or click the menu bar at the top of the screen to pause 
  editing and access the dropdown menus. Use [Left/Right] to change 
  menus, [Up/Down] to navigate options, and [Enter] to execute. 

* FILE BROWSER
  Opens dynamically when you choose to open a file.

----------------------------------------------------------------------
2. KEYBOARD SHORTCUTS
----------------------------------------------------------------------
[ F1 ]                Open File (Launches File Browser)
[ F2 ]                Save File
[ F3 ]                New File
[ F4 ]                Change Syntax Theme
[ F5 ]                Toggle Line Numbers
[ F9 ]                Toggle Menu Mode
[ Ctrl + C ]          Copy selected text
[ Ctrl + X ]          Cut selected text
[ Ctrl + V ]          Paste from clipboard
[ Ctrl + Z ]          Undo last action
[ Ctrl + Y ]          Redo last undone action
[ Ctrl + F ]          Find text
[ Shift + Arrows ]    Select text
[ Tab ]               Insert 4 spaces (Auto-aligned)
[ Esc ]               Close active menu / Cancel dialog
[ Esc ] (Press 3x)    Force Quit Editor

----------------------------------------------------------------------
3. MOUSE CONTROLS
----------------------------------------------------------------------
TE features comprehensive mouse support (if your terminal allows it):
* Left Click: Move the cursor to the clicked location or select menus.
* Click & Drag: Highlight and select text.
* Right Click: Opens a floating context menu (Undo, Redo, Cut, Copy, 
  Paste) right at your cursor position.
* Scroll Wheel: Scroll the document vertically.

----------------------------------------------------------------------
4. MENUS OVERVIEW
----------------------------------------------------------------------
- File: New, Open, Save, Save as, and Exit.
- Edit: Undo, Redo, Cut, Copy, Paste, and Find.
- Menu: Toggle Line Numbers, Change Theme, and open the Colors tool.
- Help: View this User Manual or the About page.
- Fun: Quirky features including a Coffee Break Simulator and an 
  automated poet ("Write it for me").

----------------------------------------------------------------------
5. ADVANCED FEATURES
----------------------------------------------------------------------

THE FILE BROWSER (Triggered via F1 or File -> Open)
Navigate your local directories to open files easily.
  [ Up / Down ]   : Scroll through the file list.
  [ Enter ]       : Open a file or enter a directory.
  [ Backspace ]   : Go up to the parent directory.
  [ T ]           : Toggle between showing all files or Text files only.
  [ Esc ]         : Cancel and return to the editor.

THE COLORS MENU (Triggered via Menu -> Colors)
An interactive pop-up that allows you to change the background and 
foreground color of the editor canvas itself.
  [ Tab ]         : Switch focus between Background and Foreground panes.
  [ Arrows ]      : Navigate the color swatches.
  [ Enter ]       : Apply your chosen colors and return.

FIND & FIND NEXT (Triggered via Ctrl+F)
Type a word to jump to its location in the document. 
Want to find the next occurrence? Simply press [Ctrl + F] and hit 
[Enter] without typing anything to instantly repeat your last search!

TEXT SELECTION & CLIPBOARD
You can select text using [Shift + Arrow Keys] or your mouse. TE 
integrates natively with your operating system's clipboard using the 
`pyperclip` module, allowing you to copy/paste directly between TE 
and your other desktop applications.

----------------------------------------------------------------------
6. ABOUT & DISCLAIMER
----------------------------------------------------------------------
TEdit / TE - Public Version 2.7.0
Copyright 2024-26, All Rights Reserved.
Software provided 'as-is', use at your own risk; creator assumes no 
liability. Github: https://github.com/alby13/TE-Text-Editor