append

---

Komenda append umożliwia programom otwieranie plików danych w określonych katalogach tak, jakby znajdowały się w bieżącym katalogu. Wprowadzona w MS-DOS 3.3, dostępna we wszystkich wersjach DOS i Windows aż do Windows 8/Server 2012 R2. W Windows 10 i nowszych append nie jest wspierane i zwraca błąd o braku rozpoznania polecenia.

---

Opis

append to zewnętrzne narzędzie (plik append.exe) działające w modelu TSR (Terminate-and-Stay-Resident), które:

• Dodaje katalogi do wewnętrznej listy ścieżek używanej przez programy DOS-owe.
• Wyświetla bieżącą listę, jeśli wywołane bez parametrów.
• Czyści listę, gdy użyje się samego średnika ;.

---

Składnia

append [[<drive>:]<ścieżka>[;...]] [/x[:on|:off]] [/path[:on|:off]] [/e]
append ;

• <drive>:<ścieżka>[;...] – jedna lub wiele ścieżek do listy.
• /x:on – dołącza katalogi do wyszukiwania plików i uruchamiania programów.
• /x:off – dołącza tylko do otwierania plików.
• /path:on – uwzględnia katalogi nawet przy pełnej ścieżce pliku.
• /path:off – wyłącza efekt /path:on.
• /e – zapisuje kopię listy w zmiennej środowiskowej APPEND (pierwsze użycie).
• ; – czyści listę.
• /? – wyświetla pomoc.

---

Parametry

Parametr	Opis
<ścieżka>[;...]	Ścieżki katalogów do dołączenia do listy wyszukiwania plików danych.
/x:on	Dołącza katalogi do wyszukiwania plików i uruchamiania programów.
/x:off	Dołącza katalogi tylko do otwierania plików.
/path:on	Pozwala na uwzględnianie katalogów przy otwieraniu plików z podaniem ścieżki.
/path:off	Wyłącza efekt /path:on.
/e	Przechowuje kopię listy w zmiennej APPEND (działa tylko przy pierwszym wywołaniu po starcie systemu).
;	Czyści listę dołączanych katalogów; przywraca wyszukiwanie tylko w bieżącym katalogu.
/?	Wyświetla podsumowanie składni i parametrów w wierszu poleceń.

---

Przykłady użycia

1. Dodanie katalogu D:\DANE

   append D:\DANE

   Po wpisaniu append bez parametrów zobaczysz „D:\DANE” na liście.

2. Dodanie wielu katalogów

   append C:\LOGI;E:\ARCHIWUM

   Lista to C:\LOGI, E:\ARCHIWUM.

3. Czyszczenie listy

   append ;

   Przywraca domyślne zachowanie wyszukiwania tylko w bieżącym katalogu.

4. Zapisanie listy w zmiennej

   append /e

   Tworzy zmienną APPEND z kopią listy katalogów.

---

Uwagi

• append dotyczy tylko programów korzystających z DOS-owych funkcji plikowych; większość aplikacji Win32 go ignoruje.
• W Windows 10 i nowszych komenda nie jest dostępna.
• Do operacji na plikach tekstowych w skryptach częściej używa się operatora >>.
• /e działa tylko raz po starcie systemu; kolejne wywołania są ignorowane.
• Po załadowaniu append pozostaje w pamięci jako TSR aż do wyłączenia komputera.

---

Najczęściej spotykane błędy i jak je naprawić

Błąd	Przyczyna	Rozwiązanie
'append' nie jest rozpoznawane jako polecenie...	append.exe nie istnieje w systemie (Windows 10+).	Użyj path lub operatora >>, albo pracuj w środowisku DOS lub starszym Windows.
Invalid switch or parameter	Literówka w parametrze (np. /x:on: zamiast /x:on).	Sprawdź składnię przy pomocy append /?.
No such file or directory	Podana ścieżka nie istnieje.	Zweryfikuj i popraw ścieżkę.
Brak efektu po append	Aplikacja nie korzysta z DOS-owego wyszukiwania plików.	Upewnij się, że program używa funkcji DOS; w aplikacjach Win32 append jest pomijane.
Lista nie jest zapisywana po /e	/e użyte ponownie po starcie systemu.	Użyj /e tylko przy pierwszym wywołaniu w sesji lub ustaw ręcznie zmienną APPEND.
Operator >> nie działa jak append	Mylenie append z operatorem >>.	append do ścieżek danych, >> do przekierowania wyjścia do pliku.

Porada: Dla trwałego ustawiania ścieżek w nowoczesnych skryptach użyj zmiennych środowiskowych PATH lub mechanizmów PowerShell.