Picolisp Installation

# 21nov20 Software Lab. Aleksandro Burger


         Instalado de PicoLisp
         =====================


PicoLisp bezonas kongruan sistemon POSIX kaj la LLVM-infrastrukturon. Ĝi
subtenas du instalajn strategiojn: Loka kaj Tutmonda.

Por tutmonda instalado, permesante tutsisteman aliron al la plenumebla kaj
bibliotekaj / dokumentaj dosieroj, vi povas aŭ instali ĝin de preta
distribuo, aŭ agordi iujn simbolajn ligojn al unu el la loka instalado
dosierujoj kiel priskribite sube.

Notu, ke vi ankoraŭ rajtas havi lokajn instalaĵojn kune kun tutmonda
instalado, kaj alvoku ilin eksplicite laŭplaĉe.

PicoLisp Installation

=====================

PicoLisp needs a POSIX compatible system and the LLVM infrastructure. It supports two installation strategies: Local and Global.

For a global installation, allowing system-wide access to the executable and library/documentation files, you can either install it from a ready-made distribution, or set some symbolic links to one of the local installation directories as described below.

Note that you are still free to have local installations along with a global installation, and invoke them explicitly as desired.

      Loka Instalado
      ------------------

La jenaj instrukcioj funkcias ĉe Debian Linukso. Ili devus esti similaj ĉe aliaj
sistemoj.

1. Instalu bezonatajn pakaĵojn

   $ sudo apt install make clang llvm libreadline-dev libffi-dev libssl-dev pkg-config

2. Malpaki la tarball

   $ wget https://software-lab.de/pil21.tgz
   $ tar xfz pil21.tgz

3. Ŝanĝu la dosierujon

   $ cd pil21

4. Kompili la interpretiston PicoLisp

   $ (cd src; make)

Local Installation

------------------

The following instructions work on Debian Linux. They should be similar on other systems.

1. Install required packages

$ sudo apt install make clang llvm libreadline-dev libffi-dev libssl-dev pkg-config

2. Unpack the tarball

$ wget https://software-lab.de/pil21.tgz $ tar xfz pil21.tgz

3. Change the directory

$ cd pil21

4. Compile the PicoLisp interpreter

$ (cd src; make)


      Tutmonda Instalado

      -------------------

La rekomendinda maniero por tutmonda instalado estas uzi picolisp-pakaĵon de
la OS-distribuo.

Se tio ne disponeblas, vi povas (kiel radiko) krei simbolajn ligojn de / usr / lib
kaj / usr / bin al loka instalada dosierujo:

   # ln -s / <pado> / pil21 / usr / lib / picolisp
   # ln -s / usr / lib / picolisp / bin / picolisp / usr / bin
   # ln -s / usr / lib / picolisp / bin / pil / usr / bin

Por aldona aliro al la manaj paĝoj kaj iuj ekzemploj:

   # ln -s /<pado>/pil21/man/man1/picolisp.1 / usr / share / man / man1
   # ln -s /<pado>/pil21/man/man1/pil.1 / usr / share / man / man1
   # ln -s / <pado> / pil21 / usr / share / picolisp

Global Installation

-------------------

The recommended way for a global installation is to use a picolisp package from the OS distribution.

If that is not available, you can (as root) create symbolic links from /usr/lib and /usr/bin to a local installation directory:

# ln -s /<path>/pil21 /usr/lib/picolisp # ln -s /usr/lib/picolisp/bin/picolisp /usr/bin # ln -s /usr/lib/picolisp/bin/pil /usr/bin

For additional access to the man pages and some examples:

# ln -s /<path>/pil21/man/man1/picolisp.1 /usr/share/man/man1 # ln -s /<path>/pil21/man/man1/pil.1 /usr/share/man/man1 # ln -s /<path>/pil21 /usr/share/picolisp


      Alvokado
      ----------

En tutmonda instalado oni uzu la komandon 'pil'. Vi povas aŭ komenci
en simpla aŭ en elpuriga reĝimo. La diferenco estas, ke por debug mode la komando estas
sekvita de ununura plusa signo ('+'). La '+' devas esti la plej lasta argumento pri
la komandlinio.

   $ pil # Simpla reĝimo
   :

   $ pil + # Debug mode
   :

Ambaŭkaze la dupunkto ':' estas la peto de PicoLisp. Vi eble eniros iom da Lispo
esprimo,

   : (+ 1 2 3)
   -> 6

Por forlasi la interpretiston, eniru

   : (ĝis)

aŭ simple tajpu Ctrl-D.


Por loka alvoko, specifu vojan nomon, ekz.

   $ ./pil # Simpla reĝimo
   :

   $ ./pil + # Debug mode
   :

aŭ

   $ / home / app / pil # Alvokanta lokan instaladon de iu alia dosierujo

Notu, ke 'pil' ankaŭ povas servi kiel ŝablono por viaj propraj memstaraj skriptoj.

Invocation

----------

In a global installation, the 'pil' command should be used. You can either start in plain or in debug mode. The difference is that for debug mode the command is followed by single plus ('+') sign. The '+' must be the very last argument on the command line.

$ pil # Plain mode :

$ pil + # Debug mode :

In both cases, the colon ':' is PicoLisp's prompt. You may enter some Lisp expression,

: (+ 1 2 3) -> 6

To exit the interpreter, enter

: (bye)

or just type Ctrl-D.

For a local invocation, specify a path name, e.g.

$ ./pil # Plain mode :

$ ./pil + # Debug mode :

or

$ /home/app/pil # Invoking a local installation from some other directory

Note that 'pil' can also serve as a template for your own stand-alone scripts.

      Dokumentado
      -------------

Por pliaj informoj, bonvolu rigardi "doc / index.html". Tie vi trovas la
Referenca Manlibro de PicoLisp ("doc / ref.html"), la lerniloj de PicoLisp
("doc / tut.html", "doc / native.html", "doc / select.html" kaj "doc / httpGate.html"),
kaj la oftaj demandoj ("doc / faq.html").

Kiel ĉiam, la plej ĝusta kaj kompleta dokumentado estas la fontkodo ;-)

Ajna reago bonvenas!
Mi esperas, ke vi ĝuos :-)

-------------------------------------------------- ------------------------------

   Aleksandro Burger
   Programara Laboratorio. / 7fach GmbH
   Bahnhofstr. 24a, D-86462 Langweid
   abu@software-lab.de, https://www.software-lab.de, +49 8230 5060

Documentation

-------------

For further information, please look at "doc/index.html". There you find the PicoLisp Reference Manual ("doc/ref.html"), the PicoLisp tutorials ("doc/tut.html", "doc/native.html", "doc/select.html" and "doc/httpGate.html"), and the frequently asked questions ("doc/faq.html").

As always, the most accurate and complete documentation is the source code ;-)

Any feedback is welcome! Hope you enjoy :-)

--------------------------------------------------------------------------------

Alexander Burger Software Lab. / 7fach GmbH Bahnhofstr. 24a, D-86462 Langweid abu@software-lab.de, https://www.software-lab.de, +49 8230 5060

Multilingual Texts

http:///wiki/?picolispinstallation

01sep21

admin