[plpgdoc-commit] doc/sgml start.sgml,1.1.1.1,1.2

[<ma...@us...>]

Update of /cvsroot/polishpgdoc/doc/sgml
In directory usw-pr-cvs1:/tmp/cvs-serv1093

Modified Files:
	start.sgml 
Log Message:
pierwsze tlumaczenie a.l.k.a

Index: start.sgml
===================================================================
RCS file: /cvsroot/polishpgdoc/doc/sgml/start.sgml,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -C2 -d -r1.1.1.1 -r1.2
*** start.sgml	27 Apr 2002 18:31:13 -0000	1.1.1.1
--- start.sgml	7 Jun 2002 06:24:22 -0000	1.2
***************
*** 4,54 ****
  
   <chapter id="tutorial-start">
!   <title>Getting Started</title>
  
    <sect1 id="tutorial-install">
!    <title>Installation</title>
  
     <para>
!     Before you can use <productname>PostgreSQL</productname> you need
!     to install it, of course.  It is possible that
!     <productname>PostgreSQL</productname> is already installed at your
!     site, either because it was included in your operating system
!     distribution or because the system administrator already installed
!     it.  If that is the case, you should obtain information from the
!     operating system documentation or your system administrator about
!     how to access <productname>PostgreSQL</productname>.
     </para>
  
     <para>
!     If you are not sure whether <productname>PostgreSQL</productname>
!     is already available or whether you can use it for your
!     experimentation then you can install it yourself.  Doing so is not
!     hard and it can be a good exercise.
!     <productname>PostgreSQL</productname> can be installed by any
!     unprivileged user, no superuser (<systemitem>root</systemitem>)
!     access is required.
     </para>
  
     <para>
!     If you are installing <productname>PostgreSQL</productname>
!     yourself, then refer to the <citetitle>Administrator's
!     Guide</citetitle> for instructions on installation, and return to
!     this guide when the installation is complete.  Be sure to follow
!     closely the section about setting up the appropriate environment
!     variables.
     </para>
  
     <para>
!     If your site administrator has not set things up in the default
!     way, you may have some more work to do.  For example, if the
!     database server machine is a remote machine, you will need to set
!     the <envar>PGHOST</envar> environment variable to the name of the
!     database server machine.  The environment variable
!     <envar>PGPORT</envar> may also have to be set.  The bottom line is
!     this: if you try to start an application program and it complains
!     that it cannot connect to the database, you should consult your
!     site administrator or, if that is you, the documentation to make
!     sure that your environment is properly set up.  If you did not
!     understand the preceding paragraph then read the next section.
     </para>
    </sect1>
--- 4,49 ----
  
   <chapter id="tutorial-start">
!   <title>Pierwsze kroki</title>
  
    <sect1 id="tutorial-install">
!    <title>Instalacja</title>
  
     <para>
!     Zanim zabierzesz siê za <productname>PostgreSQL</productname> musisz go oczywi¶cie
!     zainstalowaæ.  Mo¿liwe, ¿e ju¿ masz zainstalowanego 
!     <productname>PostgreSQL'a</productname>, bo byæ mo¿e by³ do³±czony do twojego systemu
!     operacyjnego lub twój administrator go zainstalowa³.
!     W takim wypadku mo¿esz otrzymaæ informacje o dostêpie
!     do <productname>PostgreSQL</productname> od administratora lub znale¼æ je w dokumentacji
!     systemu operacyjnego.
     </para>
  
     <para>
!     Je¶li nie jeste¶ pewien czy <productname>PostgreSQL</productname> jest dostêpny
!     albo czy mo¿esz go u¿ywaæ do swoich eksperymentów,
!     powiniene¶ go zainstalowaæ sam. Nie jest to trudna, a mo¿e
!     byæ dobrym æwiczeniem.
!     <productname>PostgreSQL'a</productname> mo¿e instalowaæ ka¿dy nieuprzywilejowany
!     u¿ytkownik, prawa superu¿ytkownika (<systemitem>roota</systemitem>) nie s± konieczne.
     </para>
  
     <para>
!     Gdy sam zamierzasz zainstalowaæ <productname>PostgreSQL'a</productname>,
!     zacznij od <citetitle>Podrêcznika administratora</citetitle>, a po instalacji mo¿esz
!     wróciæ do niniejszej czê¶ci.  Musisz postêpowaæ zgodnie z tym
!     rozdzia³em, aby prawid³owo ustawiæ w³a¶ciwe zmienne ¶rodowiskowe.
     </para>
  
     <para>
!     Je¿eli administrator systemu nie stosuje ustawieñ domy¶lnych, 
!     byæ mo¿e bêdziesz musia³ ustawiæ inne rzeczy, np. je¿eli 
!     serwer jest komputerem zdalnym trzeba ustawiæ zmienn± 
!     <envar>PGHOST</envar> na nazwê tego komputera. Mo¿na równie¿
!     ustawiæ zmienn± <envar>PGPORT</envar>.  Zasada jest taka: gdy 
!     spróbujesz uruchomiæ program i nie bêdziesz móg³ po³aczyæ
!     siê z baz± danych, powiniene¶ skonsultowaæ siê z administratorem,
!     je¿eli to ty, z dokumentacj± by upewniæ siê, ¿e ¶rodowisko jest
!     ustawione prawid³owo. Je¶li nie rozumiesz tego akapitu przeczytaj
!     nastêpny rozdzia³.
     </para>
    </sect1>
***************
*** 56,83 ****
  
    <sect1 id="tutorial-arch">
!    <title>Architectural Fundamentals</title>
  
     <para>
!     Before we proceed, you should understand the basic
!     <productname>PostgreSQL</productname> system architecture.
!     Understanding how the parts of
!     <productname>PostgreSQL</productname> interact will make this
!     chapter somewhat clearer.
     </para>
  
     <para>
!     In database jargon, <productname>PostgreSQL</productname> uses a
!     client/server model.  A <productname>PostgreSQL</productname>
!     session consists of the following cooperating processes
!     (programs):
  
      <itemizedlist>
       <listitem>
        <para>
!        A server process, which manages the database files, accepts
!        connections to the database from client applications, and
!        performs actions on the database on behalf of the clients.  The
!        database server program is called
!        <filename>postmaster</filename>.
         <indexterm><primary>postmaster</primary></indexterm>
        </para>
--- 51,75 ----
  
    <sect1 id="tutorial-arch">
!    <title>Podstawy architektury</title>
  
     <para>
!     Zanim rozpoczniemy powiniene¶ poznaæ podstawow± 
!     architekturê systemu <productname>PostgreSQL</productname>.
!     Ten rozdzia³ wyja¶nia jak wspó³pracuj± elementy bazy
!     <productname>PostgreSQL</productname>.
     </para>
  
     <para>
!     <productname>PostgreSQL</productname> u¿ywa modelu klient/serwer.  
!     Sesja <productname>PostgreSQL</productname>zawiera nastêpuj±ce wspó³pracuj±ce 
!     procesy (programy):
  
      <itemizedlist>
       <listitem>
        <para>
!        Proces serwera, który zarz±dza plikami bazy danych, zatwierdza
!        po³±czenia z baz± od aplikacji klienckich i na ¿±danie klienta 
!        przeprowadza operacje na bazie danych. Program ten nosi
!        nazwê <filename>postmaster</filename>.
         <indexterm><primary>postmaster</primary></indexterm>
        </para>
***************
*** 86,97 ****
       <listitem>
        <para>
!        The user's client (frontend) application that wants to perform
!        database operations.  Client applications can be very diverse
!        in nature:  They could be a text-oriented tool, a graphical
!        application, a web server that accesses the database to
!        display web pages, or a specialized database maintenance tool.
!        Some client applications are supplied with the
!        <productname>PostgreSQL</productname> distribution, most are
!        developed by users.
        </para>
       </listitem>
--- 78,87 ----
       <listitem>
        <para>
!        Aplikacja u¿ytkownika (frontend) ¿±daj±ca przeprowadzenia 
!        operacji na bazie. Mo¿e byæ narzêdziem tekstowym, aplikacj±
!        graficzn±, serwerem internetowym z dostêpem poprzez strony 
!        internetowe lub specjalizowanym programem do zarz±dzania baz±.
!        Niektóre aplikacje klienckie s± dostarczane wraz z dystrybucj±
!        <productname>PostgreSQL</productname>, ale wiêkszo¶æ jest tworzona przez u¿ytkowników.
        </para>
       </listitem>
***************
*** 101,123 ****
  
     <para>
!     As is typical of client/server applications, the client and the
!     server can be on different hosts.  In that case they communicate
!     over a TCP/IP network connection.  You should keep this in mind,
!     because the files that can be accessed on a client machine might
!     not be accessible (or might only be accessible using a different
!     file name) on the database server machine.
     </para>
  
     <para>
!     The <productname>PostgreSQL</productname> server can handle
!     multiple concurrent connections from clients.  For that purpose it
!     starts (<quote>forks</quote>) a new process for each connection.
!     From that point on, the client and the new server process
!     communicate without intervention by the original
!     <filename>postmaster</filename> process.  Thus, the
!     <filename>postmaster</filename> is always running, waiting for
!     client connections, whereas client and associated server processes
!     come and go.  (All of this is of course invisible to the user.  We
!     only mention it here for completeness.)
     </para>
    </sect1>
--- 91,110 ----
  
     <para>
!     Jak w typowych aplikacjach klient/serwer, klient oraz serwer mog±
!     znajdowaæ siê na ró¿nych komputerach.  W takim wypadku korzystaj±
!     z po³±czenia TCP/IP.  Nale¿y o tym pamiêtaæ, gdy¿ pliki dostêpne na
!     komputerze klienta mog± byæ niedostêpne na serwerze bazy danych
!     (lub mog± byæ dostêpne pod inn± nazw±).
     </para>
  
     <para>
!     Serwer <productname>PostgreSQL'a</productname> mo¿e odbieraæ wiele ¿±dañ
!     od ró¿nych klientów.  W tym celu rozpoczyna (<quote>forks</quote>) nowy 
!     proces dla ka¿dego po³±czenia.  Od tego momentu klient i nowy
!     proces serwera komunikuj± siê bez udzia³u oryginalnego 
!     procesu <filename>postmaster'a</filename>.  Tak wiêc <filename>postmaster</filename>  jest zawsze
!     uruchomiony i czeka na po³±czenia od klientów, podczas gdy  
!     przydzielony klientowi proces serwera istnieje tylko przez pewien czas.  
!     (Wszystko to jest oczywi¶cie niewidoczne dla u¿ytkownika).
     </para>
    </sect1>
***************
*** 125,129 ****
  
    <sect1 id="tutorial-createdb">
!    <title>Creating a Database</title>
  
     <indexterm zone="tutorial-createdb">
--- 112,116 ----
  
    <sect1 id="tutorial-createdb">
!    <title>Tworzenie bazy danych</title>
  
     <indexterm zone="tutorial-createdb">
***************
*** 137,186 ****
  
     <para>
!     The first test to see whether you can access the database server
!     is to try to create a database.  A running
!     <productname>PostgreSQL</productname> server can manage many
!     databases.  Typically, a separate database is used for each
!     project or for each user.
     </para>
  
     <para>
!     Possibly, your site administrator has already created a database
!     for your use.  He should have told you what the name of your
!     database is.  In this case you can omit this step and skip ahead
!     to the next section.
     </para>
  
     <para>
!     To create a new database, in this example named
!     <literal>mydb</literal>, you use the following command:
  <screen>
  <prompt>$</prompt> <userinput>createdb mydb</userinput>
  </screen>
!     This should produce as response:
  <screen>
  CREATE DATABASE
  </screen>
!     If so, this step was successful and you can skip over the
!     remainder of this section.
     </para>
  
     <para>
!     If you see a message similar to
  <screen>
  createdb: command not found
  </screen>
!     then <productname>PostgreSQL</> was not installed properly.  Either it was not
!     installed at all or the search path was not set correctly.  Try
!     calling the command with an absolute path instead:
  <screen>
  <prompt>$</prompt> <userinput>/usr/local/pgsql/bin/createdb mydb</userinput>
  </screen>
!     The path at your site might be different.  Contact your site
!     administrator or check back in the installation instructions to
!     correct the situation.
     </para>
  
     <para>
!     Another response could be this:
  <screen>
  psql: could not connect to server: Connection refused
--- 124,170 ----
  
     <para>
!     Pierwszym sposobem sprawdzenia dostêpu do serwera jest próba 
!     utworzenia bazy danych.  Uruchomiony serwer <productname>PostgreSQL</productname> mo¿e
!     zarz±dzaæ wieloma bazami.  Zazwyczaj osobne bazy s± stosowane dla 
!     ró¿nych projektów albo ró¿nych u¿ytkowników.
     </para>
  
     <para>
!     Prawdopodobnie twój administrator ju¿ utworzy³ bazê danych dla Ciebie.
!     Powinien on powiedzieæ Ci jaka jest nazwa tej bazy. W takim wypadku
!     mo¿esz przej¶æ do nastêpnego rozdzia³u.
     </para>
  
     <para>
!     Aby utworzyæ now± bazê danych, w tym przyk³adzie nazwan±
!     <literal>mydb</literal>, zastosuj nastêpuj±ce polecenie:
  <screen>
  <prompt>$</prompt> <userinput>createdb mydb</userinput>
  </screen>
!     Powiniene¶ otrzymaæ nastêpuj±c± odpowied¼:
  <screen>
  CREATE DATABASE
  </screen>
!     Je¿eli ten krok zakoñczy³ siê powodzeniem mo¿esz opu¶ciæ resztê
!     tego rozdzia³u.
     </para>
  
     <para>
!     Je¿eli zobaczysz nastêpuj±cy komunikat:
  <screen>
  createdb: command not found
  </screen>
!     to <productname>PostgreSQL</> nie zosta³ zainstalowany prawid³owo.  Ewentualnie
!     nie w ca³o¶ci, albo ¶cie¿ka dostêpu zosta³a ¼le ustawiona.  Spróbuj 
!     wywo³aæ polecenie podaj±c ca³± ¶cie¿kê dostêpu:
  <screen>
  <prompt>$</prompt> <userinput>/usr/local/pgsql/bin/createdb mydb</userinput>
  </screen>
!     U Ciebie ¶cie¿ka mo¿e byæ inna.  Skontaktuj siê z administratorem
!     lub zagl±dnij do opisu instalacji aby poprawiæ t± sytuacjê.
     </para>
  
     <para>
!     Mo¿e wyst±piæ równie¿ taki komunikat:
  <screen>
  psql: could not connect to server: Connection refused
***************
*** 189,227 ****
  createdb: database creation failed
  </screen>
!     This means that the server was not started, or it was not started
!     where <command>createdb</command> expected it.  Again, check the
!     installation instructions or consult the administrator.
     </para>
  
     <para>
!     If you do not have the privileges required to create a database,
!     you will see the following:
  <screen>
  ERROR:  CREATE DATABASE: permission denied
  createdb: database creation failed
  </screen>
!     Not every user has authorization to create new databases.  If
!     <productname>PostgreSQL</productname> refuses to create databases
!     for you then the site administrator needs to grant you permission
!     to create databases.  Consult your site administrator if this
!     occurs.  If you installed <productname>PostgreSQL</productname>
!     yourself then you should log in for the purposes of this tutorial
!     under the user account that you started the server as.
! 
      <footnote>
       <para>
!       As an explanation for why this works:
!       <productname>PostgreSQL</productname> user names are separate
!       from operating system user accounts.  If you connect to a
!       database, you can choose what
!       <productname>PostgreSQL</productname> user name to connect as;
!       if you don't, it will default to the same name as your current
!       operating system account.  As it happens, there will always be a
!       <productname>PostgreSQL</productname> user account that has the
!       same name as the operating system user that started the server,
!       and it also happens that that user always has permission to
!       create databases.  Instead of logging in as that user you can
!       also specify the <option>-U</option> option everywhere to select
!       a <productname>PostgreSQL</productname> user name to connect as.
       </para>
      </footnote>
--- 173,209 ----
  createdb: database creation failed
  </screen>
!     Oznacza to, ¿e serwer nie wystartowa³ albo nie zosta³ 
!     uruchomiony tam gdzie spodziewa³ siê <command>createdb</command>. 
!     Sprawd¼ ponownie opis instalacji lub skonsultuj siê z
!     administratorem.
     </para>
  
     <para>
!     Je¿eli nie posiadasz uprawnieñ wymaganych do utworzenia bazy 
!     danych zobaczysz nastêpuj±cy komunikat:
  <screen>
  ERROR:  CREATE DATABASE: permission denied
  createdb: database creation failed
  </screen>
!     Nie ka¿dy u¿ytkownik ma uprawnienia do tworzenia baz danych.
!     Je¶li <productname>PostgreSQL</productname> odmawia utworzenia bazy, wtedy administrator 
!     powinien nadaæ Ci takie uprawnienia. Je¿eli zajdzie taka potrzeba 
!     skontaktuj siê z administratorem. W przypadku gdy sam instalowa³e¶
!     <productname>PostgreSQL'a</productname> powiniene¶ u¿yæ konta, na którym uruchomi³e¶
!     serwer.
      <footnote>
       <para>
!       Wyja¶nijmy zasadê dzia³ania:
!       Nazwy u¿ytkowników <productname>PostgreSQL'a </productname> s± niezale¿ne od
!       kont u¿ytkowników systemu operacyjnego.  Gdy ³±czysz siê z baz±
!       mo¿esz wybraæ na jakie konto <productname>PostgreSQL'a</productname> siê zalogujesz;
!       Je¶li nie podasz nazwy u¿ytkownika, domy¶lnie zostanie 
!       przyjêta nazwa aktualnie zalogowanego w systemie 
!       operacyjnym u¿ytkownika.  W takim wypadku, zawsze bêdzie
!       konto <productname>PostgreSQL'a</productname> o nazwie takiej jak u¿ytkownik systemu 
!       operacyjnego, który uruchomi³ serwer. Najczê¶ciej bêdzie on mia³
!       uprawnienia do tworzenia baz.  Aby zalogowaæ siê do bazy jako
!       wybrany u¿ytkownik nale¿y skorzystaæ z opcji <option>-U</option> 
!       i podaæ nazwê u¿ytkownika <productname>PostgreSQL'a</productname>.
       </para>
      </footnote>
***************
*** 229,240 ****
  
     <para>
!     You can also create databases with other names.
!     <productname>PostgreSQL</productname> allows you to create any
!     number of databases at a given site.  Database names must have an
!     alphabetic first character and are limited to 31 characters in
!     length.  A convenient choice is to create a database with the same
!     name as your current user name.  Many tools assume that database
!     name as the default, so it can save you some typing.  To create
!     that database, simply type
  <screen>
  <prompt>$</prompt> <userinput>createdb</userinput>
--- 211,221 ----
  
     <para>
!     Mo¿esz równie¿ tworzyæ bazy z innymi nazwami.
!     <productname>PostgreSQL</productname> zezwala ci na utworzenie dowolnej liczby baz na
!     jednym serwerze.  Nazwy baz danych musz± zaczynaæ siê od 
!     litery i s± ograniczone do 31 znaków.  Wygodnym sposobem jest
!     tworzenie baz danych z nazwami odpowiadaj±cymi nazwie 
!     u¿ytkownika.  Wiele narzêdzi przyjmuje tak± nazwê domy¶lnie.
!     Aby w prosty sposób utworzyæ bazê, wpisz:
  <screen>
  <prompt>$</prompt> <userinput>createdb</userinput>
***************
*** 243,258 ****
  
     <para>
!     If you don't want to use your database anymore you can remove it.
!     For example, if you are the owner (creator) of the database
!     <literal>mydb</literal>, you can destroy it using the following
!     command:
  <screen>
  <prompt>$</prompt> <userinput>dropdb mydb</userinput>
  </screen>
!     (For this command, the database name does not default to the user
!     account name.  You always need to specify it.)  This action
!     physically removes all files associated with the database and
!     cannot be undone, so this should only be done with a great deal of
!     forethought.
     </para>
    </sect1>
--- 224,237 ----
  
     <para>
!     Gdy nie bêdziesz ju¿ chcia³ u¿ywaæ swojej bazy mo¿esz j± usun±æ.
!     Na przyk³ad, je¶li jestej w³a¶cicielem (tym który j± utworzy³) bazy
!     <literal>mydb</literal>, mo¿esz j± usun±æ przy u¿yciu nastêpuj±cego polecenia:
  <screen>
  <prompt>$</prompt> <userinput>dropdb mydb</userinput>
  </screen>
!     (To polecenie nie przyjmuje domy¶lnie nazwy bazy danych, 
!     zawsze musisz j± podawaæ wprost).  Czynno¶æ ta fizycznie 
!     usuwa wszystkie pliki nale¿±ce do bazy i jest nieodwracalna,
!     wiêc nale¿y j± stosowaæ z ostro¿no¶ci±.
     </para>
    </sect1>
***************
*** 260,264 ****
  
    <sect1 id="tutorial-accessdb">
!    <title>Accessing a Database</title>
  
     <indexterm zone="tutorial-accessdb">
--- 239,243 ----
  
    <sect1 id="tutorial-accessdb">
!    <title>Dostêp do bazy danych</title>
  
     <indexterm zone="tutorial-accessdb">
***************
*** 267,279 ****
  
     <para>
!     Once you have created a database, you can access it by:
  
      <itemizedlist spacing="compact" mark="bullet">
       <listitem>
        <para>
!        Running the <productname>PostgreSQL</productname> interactive
!        terminal program, called <application><firstterm>psql</></application>, which allows you
!        to interactively enter, edit, and execute
!        <acronym>SQL</acronym> commands.
        </para>
       </listitem>
--- 246,257 ----
  
     <para>
!     Po utworzenie bazy mo¿esz mieæ do niej dostêp przez:
  
      <itemizedlist spacing="compact" mark="bullet">
       <listitem>
        <para>
!        Uruchomienie interaktywnego terminala <productname>PostgreSQL</productname> 
!        o nazwie <application><firstterm>psql</></application>, który zezwala na wprowadzanie, edycjê 
!        i wykonywanie poleceñ <acronym>SQL</acronym>.
        </para>
       </listitem>
***************
*** 281,289 ****
       <listitem>
        <para>
!        Using an existing graphical frontend tool like
!        <application>PgAccess</application> or
!        <application>ApplixWare</application> (via
!        <acronym>ODBC</acronym>) to create and manipulate a database.
!        These possibilities are not covered in this tutorial.
        </para>
       </listitem>
--- 259,266 ----
       <listitem>
        <para>
!        U¿ycie istniej±cych narzêdzi graficznych jak <application>PgAccess</application> 
!        or <application>ApplixWare</application> (przez <acronym>ODBC</acronym>) do tworzenia i zarz±dzania
!        baz± danych.  Ich mo¿liwo¶ci nie s± opisane w niniejszym
!        opracowaniu.
        </para>
       </listitem>
***************
*** 291,352 ****
       <listitem>
        <para>
!        Writing a custom application, using one of the several
!        available language bindings.  These possibilities are discussed
!        further in <citetitle>The PostgreSQL Programmer's
!        Guide</citetitle>.
        </para>
       </listitem>
      </itemizedlist>
  
!     You probably want to start up <command>psql</command>, to try out
!     the examples in this tutorial.  It can be activated for the
!     <literal>mydb</literal> database by typing the command:
  <screen>
  <prompt>$</prompt> <userinput>psql mydb</userinput>
  </screen>
!     If you leave off the database name then it will default to your
!     user account name.  You already discovered this scheme in the
!     previous section.
     </para>
  
     <para>
!     In <command>psql</command>, you will be greeted with the following
!     message:
  <screen>
! Welcome to psql, the PostgreSQL interactive terminal.
!  
! Type:  \copyright for distribution terms
!        \h for help with SQL commands
!        \? for help on internal slash commands
!        \g or terminate with semicolon to execute query
!        \q to quit
   
  mydb=&gt;
  </screen>
      <indexterm><primary>superuser</primary></indexterm>
!     The last line could also be
  <screen>
  mydb=#
  </screen>
!     That would mean you are a database superuser, which is most likely
!     the case if you installed <productname>PostgreSQL</productname>
!     yourself.  Being a superuser means that you are not subject to
!     access controls.  For the purpose of this tutorial this is not of
!     importance.
     </para>
  
     <para>
!     If you have encountered problems starting <command>psql</command>
!     then go back to the previous section.  The diagnostics of
!     <command>psql</command> and <command>createdb</command> are
!     similar, and if the latter worked the former should work as well.
     </para>
  
     <para>
!     The last line printed out by <command>psql</command> is the
!     prompt, and it indicates that <command>psql</command> is listening
!     to you and that you can type <acronym>SQL</acronym> queries into a
!     work space maintained by <command>psql</command>.  Try out these
!     commands:
      <indexterm><primary>version</primary></indexterm>
  <screen>
--- 268,324 ----
       <listitem>
        <para>
!        Napisanie w³asnej aplikacji przy zastosowaniu jednego z wielu
!        dostêpnych wbudowanych jêzyków.  Ta mo¿liwo¶æ jest opisana
!        szerzej w <citetitle>Podrêczniku Programisty</citetitle>.
        </para>
       </listitem>
      </itemizedlist>
  
!     Prawdopodobnie zechcesz uruchomiæ <command>psql</command>, aby sprawdziæ
!     przyk³ady podane w tym podrêczniku.  Bazê <literal>mydb</literal> 
!     mo¿na uruchomiæ poleceniem:
  <screen>
  <prompt>$</prompt> <userinput>psql mydb</userinput>
  </screen>
!     Gdy nie podasz nazwy bazy zostanie przyjêta domy¶lnie nazwa
!     twojego konta. Powiniene¶ o tym przeczytaæ w poprzednim rozdziale.
     </para>
  
     <para>
!     Program <command>psql</command> powita Ciê komunikatem:
  <screen>
! Witamy w psql, interaktywnym programie do komunikowania siê z serwerem PostgreSQL.
! 
! Wpisz: \copyright aby przeczytaæ informacje prawne
!        \h aby uzyskaæ pomoc do poleceñ SQL
!        \? aby uzyskaæ pomoc do poleceñ wewnêtrznych
!        \g lub ¶rednik, aby zakoñczyæ i wykonaæ zapytanie SQL
!        \q aby wyj¶æ
   
  mydb=&gt;
  </screen>
      <indexterm><primary>superuser</primary></indexterm>
!     Ostatnia linia mo¿e równie¿ wygl±daæ tak:
  <screen>
  mydb=#
  </screen>
!     Oznacza to, ¿e jeste¶ administratorem tej bazy, co jest 
!     bardzo prawdopodobne je¶li to ty instalowa³e¶ <productname>PostgreSQL</productname>.
!     Bycie administratorem oznacza, ¿e nie podlegasz kontroli dostêpu.
!     Z punktu widzenia niniejszego opracowania nie jest to istotne.
     </para>
  
     <para>
!     Je¶li napotka³e¶ problemy podczas uruchomienia <command>psql</command>
!     wróæ do wcze¶niejszego rozdzia³u.  Diagnozowanie <command>psql</command> 
!     i <command>createdb</command> jest podobne, je¶li dzia³a drugie, to pierwsze
!     te¿ bêdzie dzia³aæ.
     </para>
  
     <para>
!     Ostatnia linia wy¶wietlona przez <command>psql</command> jest znakiem 
!     zachêty i oznacza, ¿e <command>psql</command> oczekuje na wprowadzenie
!     zapytañ <acronym>SQL</acronym> do obszaru roboczego utworzonego przez
!     <command>psql</command>.  Spróbuj wpisaæ poni¿sze polecenia:
      <indexterm><primary>version</primary></indexterm>
  <screen>
***************
*** 372,382 ****
  
     <para>
!     The <command>psql</command> program has a number of internal
!     commands that are not SQL commands.  They begin with the backslash
!     character, <quote><literal>\</literal></quote>.  Some of these
!     commands were listed in the welcome message.  For example,
!     you can get help on the syntax of various
!     <productname>PostgreSQL</productname> <acronym>SQL</acronym>
!     commands by typing:
  <screen>
  <prompt>mydb=&gt;</prompt> <userinput>\h</userinput>
--- 344,352 ----
  
     <para>
!     Program <command>psql</command> posiada pewn± liczbê poleceñ, które nie s± 
!     poleceniami SQL.  Zaczynaj± siê znakiem <quote><literal>\</literal></quote>.  Niektóre
!     z nich s± zawarte w powitalnym komunikacie.  Na przyk³ad, mo¿esz
!     przegl±daæ pomoc na temat sk³adni ró¿nych komend
!     <productname>Postgresowego</productname> <acronym>SQL</acronym> po wpisaniu:
  <screen>
  <prompt>mydb=&gt;</prompt> <userinput>\h</userinput>
***************
*** 385,402 ****
  
     <para>
!     To get out of <command>psql</command>, type
  <screen>
  <prompt>mydb=&gt;</prompt> <userinput>\q</userinput>
  </screen>
!     and <command>psql</command> will quit and return you to your
!     command shell. (For more internal commands, type
!     <literal>\?</literal> at the <command>psql</command> prompt.)  The
!     full capabilities of <command>psql</command> are documented in the
!     <citetitle>Reference Manual</citetitle>.  If <productname>PostgreSQL</> is
!     installed correctly you can also type <literal>man psql</literal>
!     at the operating system shell prompt to see the documentation.  In
!     this tutorial we will not use these features explicitly, but you
!     can use them yourself when you see fit.
!    </para>
  
    </sect1>
--- 355,369 ----
  
     <para>
!     Aby zakoñczyæ <command>psql</command>, wpisz:
  <screen>
  <prompt>mydb=&gt;</prompt> <userinput>\q</userinput>
  </screen>
!     a <command>psql</command> zakoñczy pracê i powróci do wiersza poleceñ.
!     (Wiêcej wewnêtrznych poleceñ poznasz wpisuj±c <literal>\?</literal> 
!     w wierszu poleceñ <command>psql'a</command>.)  Wszystkie mo¿liwo¶ci
!     <command>psql'a</command> s± opisane w <citetitle>Podrêczniku U¿ytkownika</citetitle>.  
!     Je¶li <productname>PostgreSQL</> zosta³ zainstalowany prawid³owo mo¿esz
!     tak¿e u¿ywaæ <literal>man psql</literal> w lini poleceñ systemu operacyjnego.
! </para>
  
    </sect1>