﻿ ______________________________________________________________________________
|                                                                              |
|   FRename3 v2.01                     (c) 2014+ Pepak, https://www.pepak.net  |
|______________________________________________________________________________|

To jest wtyczka służąca do zmiany nazw plików, bazująca na wtyczce FRename
autorstwa Jouri Mamev (https://plugring.farmanager.com/plugin.php?pid=464).
Została ona całkowicie przepisana i uaktualniona do pracy z nowymi wersjami
FAR. Tam gdzie wydawało mi się przydatne, dodałem także nowe możliwości.



UŻYCIE
------

W panelu, należy zaznaczyć pliki którym trzeba zmienić nazwy i wywołać
wtyczkę z Menu wtyczek (F11). Lista plików zostanie otwarta w edytorze FAR
w dwóch kolumnach; po lewej znajdować się będą oryginalne nazwy plików,
po prawej nowe nazwy plików. Można edytować nazwy w dowolny sposób, używając
wszelkich dostępnych zasobów. Po zakończeniu edycji, wtyczka przeskanuje
plik linia po linii i zmieni nazwy plików zgodnie z podaną propozycją.

Aby ułatwić proces edycji, dostępne są klawisze skrótów (opcje dostępne
także z poziomu Menu wtyczek - F11):

  ALT+F1 .... Jeżeli kursor będzie znajdował się w linii z nazwą pliku,
              kursor przeskoczy na pierwszy znak nowej nazwy pliku.
  ALT+F2 .... Zaznacza pionowy blok ze wszystkimi nazwami docelowymi.
              Można wtedy np. uruchomić zmianę wielkości znaków lub
              masowo zamienić znaki w bloku. Proszę zwrócić uwagę,
              że znaki cudzysłowia także są zaznaczane!
  ALT+F3 .... Usuwa docelową nazwę pliku od pozycji kursora do rozszerzenia
              pliku. W pliku "FRename3.lua" można znaleźć przykład,
              jak przypisać tę funkcję do skrótu CTRL+D jeżeli żaden blok
              nie jest zaznaczony.
  ALT+F4 .... Przenosi kursor do rozszerzenia pliku docelowego.
  ALT+F5 .... Sprytny POCZĄTEK - przełącza kursor pomiędzy nazwą docelową,
              a początkiem linii.
  ALT+F6 .... Sprytny KONIEC - przełącza kursor pomiędzy rozszerzeniem
              docelowego pliku, a końcem linii.

Klawisze skrótu mogę włączane/wyłączane w konfiguracji wtyczki.
Można wtedy skorzystać z dostępnych poleceń wtyczki, aby zdefiniować według
własnych upodobań.


LICENCJA
--------

Wtyczka została wydana na zmodyfikowanej (3 klauzulowej) licencji BSD.
Szczegóły w pliku licence.txt



KOMPILACJA WTYCZKI
-------------------

Musisz posiadać Delphi w wersji przynajmniej 2009. Starsze wersje nie są
obsługiwane. Nowsze wersje powinny działać poprawnie, testowałem kompilacje
na wersji Delphi XE2 oraz 2009, a większość kodu biblioteki została
przetestowana na wersji XE4.

Upewnij się, że posiadasz na zmiennej PATH folder BIN z Delphi, przejdź
do folderu SOURCE i uruchom BUILD. Powinieneś otrzymać nowy plik
FRename3.dll w folderze BIN.

Możesz użyć kilku opcji w linii poleceń podczas kompilowania (BUILD).
Najważniejsze z nich to:

    FAR2 ........ Kompiluje wersję zgodną z FAR2.
    FAR3 ........ Kompiluje wersję zgodną z FAR3 (domyślnie).
    X86 ......... Kompiluje 32-bitową wersję wtyczki (domyślnie).
    X64 ......... Kompiluje 64-bitową wersję wtyczki.



KONTAKT
-------

Jeżeli masz jakieś pytania lub chcesz zaproponować nową opcję, możesz zrobić to
na forum FAR w wątku FRename3 ( https://forum.farmanager.com/viewtopic.php?f=39&t=9719 ),
lub na moim forum ( https://forum.pepak.net ).
