@database ALynx.guide @$VER ALynx.guide 0.11 (3.10.95) @node MAIN "ALynx Documentation - Contents" ALynx_2.4-FM AmigaPort 1.31 (10/15/95) ASCII-Web-Browser for Amiga/AmiTCP/MLink ported to Amiga in 1995 by P.Marquardt @{" What is it ? " link DESCRIPTION} @{" Usage " link USAGE} @{" Betatester " link BETATESTER} @{" Author " link AUTHOR} @{" Problems " link PROBLEMS} @{" People " link HELPERS} @{" Notes " link NOTES} @{" Commands " link COMMANDS} @{" Goodies " link GOODIES} @{" History " link HISTORY} @{" lynx.cfg " link LYNXCFG} @{" Files " link FILES} ALynx Homepage: http://www.fhi-berlin.mpg.de/amiga/alynx.html ALynx IRC-bot : "/msg CamAI send alynx" @endnode @index INDEX @node GOODIES "other files in distribution" ************************************************************************* * Goodies * ************************************************************************* Some goodies are distributed within the ALynx archive: @{"ReSize.lha" link RESIZE} handle LINES/COLS Mosaic_Shunt.rexx modified version from Peter Hanrahan Nudel_MALS.lha Other shunt-proggie from Leo Davidson copystripper.rexx kludge to handle DOWNLOADER: option mail.rexx simple mailclient which requires AmiTCPs TCP:-device Josef Feel free to send other tools/features for use with ALynx. Send to marquardt_p@mpimg-berlin-dahlem.mpg.de or marquardt_p@fhi-berlin.mpg.de @endnode @node DESCRIPTION "original description of lynx" ************************************************************************* * DESCRIPTION * * (from the original-distribution-docs) * ************************************************************************* Lynx is a general-purpose distributed information browser and is part of the World Wide Web project. Lynx was designed to support a Campus Wide Information System (CWIS), but can be used for many other applications. When it is started, Lynx is given a local path specifying a file containing text to be displayed, or a Uniform Resource Locator (URL) that specifies a resource to be displayed (usually the name of a file containing text information), the type of server that will provide the resource, and the Internet address of the system on which the specified server is running. If the URL or path specifies a hypertext file, that file will be a standard ASCII text file in which hypertext links are embedded. The simplest hypertext link is just a URL designating another resource which itself may contain both text and links. When a hypertext document is being displayed, links appear different from standard text, and users press the up- or down-arrows to "select" a particular link. Selected links show up as highlighted text, and users press Return or right arrow when a link is highlighted to "follow" the selected link. When the link is followed Lynx finds the associated file and displays it on the screen in place of the first file. Lynx data files can reside on any accessable local file system. (i.e. NFS, AFS, etc.), or on remote servers. Currently supported remote servers are HTTP, Gopher, FTP, NNTP, and WAIS. A single hypertext file may include links pointing to multiple remote servers, so that Lynx provides a truly distributed hypertext system. Lynx is available for most flavors of Unix and VMS This Un*x version of Lynx should work on any system with a reasonable Curses implementation @endnode @node NOTES "some notes about ALynx" ************************************************************************* * Notes * ************************************************************************* o This is a port. Don't expect everthing to work! o AmiTCP-Version (ALynx) works fine with AmiTCP and MLink o AS225-Version (Alynx_AS225) works fine with AS225r2 or I-Net 225 but doesn't work with MLink. Reported by Osma Ahvenlampi o @{"files" link FILES} needed: AMITCP:db/Lynx.cfg or INET:db/Lynx.cfg or PROGDIR:Lynx.cfg ENV:Mosaic/mailcap (configurable via @{"Lynx.cfg" link LYNXCFG}) ENV:Mosaic/mime.types (configurable via @{"Lynx.cfg" link LYNXCFG}) o To use a simple curses-screen type @{b}1> ; call alynx on own screen (WB clone)@{ub} @{b}1> alynx -term screen http://taa.dah.com@{ub} or set the environmentvar CURSESTYPE to @{"SCREEN" link SCREENSETTINGS} @{b}1> ; use own screen@{ub} @{b}1> setenv CURSESTYPE screen@{ub} ALynx runs in a CLI-Shell-Window (amigados/bbs) by default. To force it to ANSI-mode: @{b}1> alynx -term ansi http://taa.dah.com@{ub} or @{b}1> ; run in this shellwindow@{ub} @{b}1> setenv CURSESTYPE ANSI@{ub} o If your shell doesn't set the environment-variables LINES & COLS use @{"ReSize" link RESIZE} which is included in the ALynx archive. o until now no DIRED-support o BBS-Sysops: Be careful by installing ALynx on a non-MuFS-BBS-System!!! There is no fileprotection in ALynx. I don't take any responsibility if someone trashes your local filesystem. Lynx is designed to work in a protected Unix/VMS-filesystem. I'll try to fix this, but this is really hard work. If you find any holes, TELL ME! o There is, and there will never be direct inline-gfx/mouse-support What works: (reported by several people) o AUTH o Proxy o almost everything o e-mail o ftp, gopher Todo: o DIRED o more colors (this IS heavy stuff) @endnode @node USAGE "how to start ALynx" ************************************************************************* * Usage * ************************************************************************* Just start ALynx with a valid URL. @{b}1> alynx Your://favourite/URL/to/look/at@{ub} To see the commandlineoptions try @{b}-help@{ub} Take a look at @{" ENV:-Vars " link ENVVARS}! Also don't forget to take a look at @{"lynx.cfg" link LYNXCFG}! @endnode @node RESIZE "setting window bounds" ************************************************************************* * ReSize * ************************************************************************* To use ReSize, just unpack ReSize.lha, read ReSize.readme and copy it to any directory in your path. ReSize is a small tool to calculate the number of rows/columns of the current active cli-window and set environment-vars accordingly. It was written due to the lack of such vars in some shells. ReSize sets $LINES $COLS $COLUMNS $SCREENMODE vars as calculated. Options of ReSize: ReSize SET ; sets local vars $LINES $COLS like "set LINES 24" ReSize SETENV ; sets same vars like "setenv LINES 24" ReSize SAVE ; same as SETENV, but also saves in ENVARC: ReSize VERBOSE ; shows, what vars would be set VERBOSE or V could be added to set and show the vars. @endnode @node ENVVARS "some vars to control ALynx" ************************************************************************* * Environment variables * ************************************************************************* ALynx understands the following environment-Variables (local/global): COLS n columns n number of columns in shellwindow. (max. 160) LINES n number of lines in shellwindow see also @{"ReSize" link RESIZE} CURSESTYPE ANSI run ALynx in shellwindow @{"CURSESTYPE SCREEN" link SCREENSETTINGS} run ALynx on own screen/pubscreen/screenmode HOME your valid home-directory @{"CURSESANSICOLORS" link COLORSETTINGS} ANSI-colormapping @{"LYNX_CFG" link LYNXCFG} location of @{"Lynx.cfg" link LYNXCFG} @endnode @node SCREENSETTINGS "how to fiddle with screens" ************************************************************************* * Screensettings * ************************************************************************* ALynx 1.12 finally introduces screenmodehandling, publicscreens and cloned workbenchscreens. This all is done by invoking ALynx with the -term=screen switch or by setting the good old CURSESTYPE to "SCREEN". The new options for this env-variable work the following way: SET CURSESTYPE SCREEN <- this creates a copy of your wb-screensize " SCREEN Mosaic <- pop up on this (existing) publicscreen " SCREEN 0x99004 <- open customscreen with this modeID ALynx will not open on publicscreens which have hexadecimal names 8) The same syntax as above regards to the -term switch. remember to use quotes when using public screen names or screenmodes: @{b}1> ALynx -term "screen 0x89024" ftp://kermit.the.frog@{ub} @endnode @node COLORSETTINGS ""how to fiddle with colors" ************************************************************************* * Colorsettings * ************************************************************************* To map certain ANSI-colors to other colors set the CURSESANSICOLORS environmentvariable. This isn't as complicated as it sounds. The default for CURSESANSICOLORS is: @{b}1> setenv CURSESANSICOLORS 01234567@{ub} To swap color 7 with color 1 just type @{b}1> setenv CURSESANSICOLORS 07234561@{ub} Got it ? Nope ? O.k. Internals. Curses uses escapesequences like "[33m" to set the colors in ANSI-mode. So, when u decide to swap color #2 with color #5, just set CURSESANSICOLORS to 01534267. Now every escapesequence which should be "[32m" will result in "[35m". My standard curses-screen: Workbench uses: BLACK 0 GREY 0 RED 1 BLACK 1 GREEN 2 WHITE 2 YELLOW 3 GREY-BLUE 3 BLUE 4 BLUE 4 CYAN 5 CYAN 5 MAGENTA 6 MAGENTA 6 WHITE 7 ORANGE 7 @{b}1> ; use BLUE as highlight-color@{ub} @{b}1> setenv CURSESANSICOLORS 01734564@{ub} No palette-requester yet. This IS a CLI-based programm. color item ANSI-mode Screen-mode ------------------------------------------------ 0/1 text: [0m (WB-black) white 2 bold: [32m (WB-greyblue) yellow 3 link: [33m (WB-white) green @endnode @node COMMANDS "the keyboard" ************************************************************************* * keystroke commands * ************************************************************************* (from lynx_help/keystroke_commands/keystroke_help.html) Btw, the following text wasn't snapped, but @{b}lynxed@{ub}: alynx -dump -nolist lynx_help/keystroke_commands/keystroke_help.html MOVEMENT: Down arrow - Highlight next topic Up arrow - Highlight previous topic Right arrow, - Jump to highlighted topic Return, Enter Left arrow - Return to previous topic SCROLLING: + (or space) - Scroll down to next page - (or b) - Scroll up to previous page DIRED: (*) c - Create a new file (*) d - Download selected file (*) e - Edit selected file (*) f - Show a full menu of options for current file (*) m - Modify the name or location of selected file (*) r - Remove selected file (*) t - Tag highlighted file (*) u - Upload a file into the current directory OTHER: ? (or h) - Help (this screen) a - Add the current link to your bookmark file c - Send a comment to the document owner d - Download the current link e - Edit the current file g - Goto a user specified URL or file i - Show an index of documents j - Execute a jump operation k - Show a list of key mappings l - List references (links) in current document m - Return to main screen o - Set your options p - Print to a file, mail, printers, or other q - Quit (Capital 'Q' for quick quit) / - Search for a string within the current document s - Enter a search string for an external search n - Go to the next search string v - View your bookmark file z - Cancel transfer in progress [backspace] - Go to the history page = - Show file and link info \\ - Toggle document source/rendered view (*) ! - Spawn your default shell * - Toggle image_links mode on and off [ - Toggle pseudo_inlines mode on and off ] - Send a HEAD request for the current doc or link CTRL-R - Reload current file and refresh the screen CTRL-W - Refresh the screen CTRL-U - Erase input line CTRL-G - Cancel input or transfer CTRL-T - Toggle trace mode on and off Use the cursor control keys to move around in Lynx. The up and down arrows move you from one selected link to another. Use the right arrow (or Return) to follow a link, and use the left arrow to return from a link. The numeric keypad, or the numbers mapped to the keypad keys, can also be used (i.e., 6-right 8-up 9-pgup 3-pgdn) (*) not implemented in Amiga-Port ALynx. @endnode @node AUTHOR "who wrote this program" ************************************************************************* * Authors * ************************************************************************* Michael Grobe, Charles Rezac, Lou Montulli Academic Computing Services University of Kansas Lawrence, Kansas 66047 Thanks to Earl Fogel, Computing Services, University of Saskatchewan, fogel@sask.usask.ca, who wrote the original hytelnet code, and Foteos Macrides who worked on many parts of the VMS code. Thanks to Jerome LAURET for converting the lynx man page to VMS help format. Amiga-Port: Peter Marquardt, Berlin, Germany marquardt_p@mpimg-berlin-dahlem.mpg.de marquardt_p@fhi-berlin.mpg.de @{b}Please DO NOT bother Lou about ALynx. Send bugs/questions/improvements only to marquardt_p@mpimg-berlin-dahlem.mpg.de or marquardt_p@fhi-berlin.mpg.de ! Thanks.@{ub} If you like me drinking lotsa coffee (which holds me awake, while porting) u may donate several tons of money to: bank / Bank : Postbank KOELN (Germany) bank# / Bankleitzahl: 370 100 50 account# / Kontonummer : 267-12-504 name / Name : P.Marquardt @endnode @node BETATESTER "how to supply bugreports" ************************************************************************* * Note to Betatesters * ************************************************************************* Send bugreports to marquardt_p@mpimg-berlin-dahlem.mpg.de marquardt_p@fhi-berlin.mpg.de Enforcerhit-reports welcome! Best reports are generated by starting Enforcer like this: @{b}run segtracker@{ub} @{b}run mungwall PRESIZE 16 POSTSIZE 16 NAMETAG SHOWFAIL SHOWHUNK@{ub} @{b}run enforcer SHOWPC STACKCHECK AREGCHECK DREGCHECK STDIO@{ub} Sorry, but I'm not able to find a LONG-READ on 0xDEADBEEF, so I just need _some_ more info 8) Tell me, what works. Well, u may also tell me, what doesn't 8))) Thanks go to @{"these people" link HELPERS} @endnode @node HELPERS "who helped a lot" ************************************************************************* * People * ************************************************************************* all these people on IRC reported bugs/features/suggestions concerning the ALynx-port: XS (XS@nil.student.uni-tuebingen.de): Andreas Otte N`Kognito (hkantola@karhu.Helsinki.FI): Heikki Kantola, genius TheRaven (bobl@graphics.rent.com): Bob Lindabury Mick (mickh@iM.Net): Michael-W. Hohmann babbage (babbage@babnet.foobar.co.uk) JamesBart (James@bartonjw.demon.co.uk) Charger (raistlin@zetor.clinet.fi): Jaska Jokunen coto (runge@egd.egd.igd.fhg.de): Thomas Runge Camelot (samzait@lk-hp-8.hut.fi): Sami Itkonen Tau (oahvenla@neppari.cs.hut.fi): Osma Ahvenlampi vito (vito@scrutinizer.RZ-Berlin.MPG.DE): Holger Behrens peterh@geko.com.au: Peter Hanrahan _3V_ (vviitane@rock.Helsinki.FI): Viljo "3V" Viitanen cosinus (cosinus@olis.North.DE): Christian Stelter Billing (billing@academy.bastad.se): http://www.bastad.se/~billing Saiful (terje@zetor.clinet.fi): Terje Bergström mwm@contessa.phone.net: Mike Meyer dmaddox@scsn.net: Donald J. Maddox steinarb@frodo.hiof.no: Steinar Birkelund Blue Thunder (dandersn@gzero.com): Dave Anderson rhurt@thepoint.net: Richard N. Hurt aalto@spit.fipnet.fi: Lauri Aalto upside@mcs.com: Dan Linder charli@primenet.com: Greg Baltzell develand@uoguelph.ca: HammerD andy@domus.demon.co.uk: Andrew Nicholson sellis@rohan.sdsu.edu: ScottE (a BIG help on AS225-version!!) paradigm@obscurity.pd.mcs.net: David Salbego barney@lupus.westfalen.de: Matthias Barnutz Josef (panther@gate.net): Josef Faulkner rbeekman@xs4all.nl: Rene Beekman fjc@wossname.apana.org.au: Frank Copeland troels.stud.cs.uit.no: Troels Walsted Hansen ---> add your name to the list: REPORT BUGS! <--- @endnode @node PROBLEMS "nah, no problems..." ************************************************************************* * Problems * ************************************************************************* - Problems with @{"ENV:Mosaic/mailcap" link PROBENVMAILCAP} - Problems with my @{"english" link ENGLISH} ---------------------------------------------------------------------------- Q: The URL http://foo.bar.com/blah.html doesn't display some items correct. I checked them with NetScape(tm) and other browsers so the error might be in ALynx. A: Before blaming ALynx/Lynx please run the page through something like htmlchek (http://uts.cc.utexas.edu/~churchh/htmlchek.html). Also it might help to run ALynx in screenmode and toggle tracemode (^T) before receiving the page. NetScape(tm) is very tolerant concerning bad HTML, so lots of pages out there _seem_ to be good HTML but actually are NOT. Iw I wuolt wrid dis gihde laik dis, yu m8 anderstand me, but thiz dohs nod mean dis iz korrect englishish. Got me ? 8) ---------------------------------------------------------------------------- Q: Control-W doesn't refresh the screen, what's up ? A: FComp on any other keyboard-patcher might swallow it. This might occur for other keys, too. Check your systemconfiguration. ---------------------------------------------------------------------------- Q: How can i disable the "Save anywhere on disk" item in the downloadmenu ? A: Comment out "DOWNLOADER:Save anywhere on disk :..." entry in lynx.cfg ---------------------------------------------------------------------------- Q: How can i set up different downloaddirs for different users on my BBS setup ? A: Edit Lynx.cfg and set DOWNLOADDIR: to any local Env-variable you like. (ex.: "DOWNLOADDIR:$USERDOWNDIR" ). Then edit the startup-script for ALynx on your BBS to set this new variable to the desired location. (in this case for example: "set USERDOWNDIR $HOME/downloads/"). The DOWNLOADDIR-option accepts directories OR vars (starting with '$'), if it doesn't exist it uses $HOME. ---------------------------------------------------------------------------- Q: How can i set up different downloaddirs in the download-menu ? A: Take a look at "goodies/copystripper.rexx". It fixes a common problem with the ALynx supplied quoted destination-filename. ---------------------------------------------------------------------------- Q: Does ALynx support the new AMosaic1.4 hotlist format ? A: No. At least not the nonstandard \@GROUP/\@ENDGROUP-tags. Sorry, I tried implementing this, but when i created a hotlist with AMosaic1.4ß it went to guruland. I'll wait 'til it's more stable. ---------------------------------------------------------------------------- Q: "when it asks what name to save it under, you can add a path there ?? ... is there a way to make it perminantly save to a particular dir ?" A: Well, Since 1.25 ALynx saves in $HOME by default. To specify another default destination either modify DOWNLOADDIR: add new entries for DOWNLOADER: in "lynx.cfg". ---------------------------------------------------------------------------- Q: "it seems to work pretty fine here with Excelsior! BBS...odd thing is that it popped my display into interlaced mode." A: You forgot to "setenv CURSESTYPE ANSI". (sorry, wasn't mentioned here) (now is default since port-release 1.2) ---------------------------------------------------------------------------- Q: "I don't have a HOME environment variable !" A: This variable will be created by default on local login via AmiTCP. On MLink you have to set this one to any location where your "home"- directory is. This location is for ALynx to search/save several files. ALynx depends on existance so "set" oder "setenv" HOME. ---------------------------------------------------------------------------- Q: "how can i get the cursor back to the current link ?" A: start ALynx with the "-show_cursor" option. ---------------------------------------------------------------------------- Q: "how can i handle bigger/smaller windowsizes ?" A: There are 2 @{"ENV-vars" link ENVVARS}, controlling the size of the current shellwindow. "COLS" & "columns" to set the number of columns. "LINES" to set the number of desired lines. The small distributed tool @{"ReSize" link RESIZE} set these automagically. ---------------------------------------------------------------------------- Q: "By the way. What's the command to clear the history buffer ?" A: There is no such command. This is Lynx-stuff. Maybe i'll implement this in later versions. ---------------------------------------------------------------------------- Q: "How can I pass it a users email address?" A: Options-Menu. [O] [P] ---------------------------------------------------------------------------- Q: "I always get -requesters after a while." A: Your T:-assignemt probably points to RAM:T/ . This is the place where ALynx puts it's history-pages, so it might fill up fast. Since version 1.18 u can tell ALynx, where to put it's tempfiles. Just take a look at @{"lynx.cfg" link LYNXCFG} and search for TEMPDIR: ---------------------------------------------------------------------------- @endnode @node PROBENVMAILCAP "mailcap & mime.types ?" ************************************************************************* * mailcap & mime.types * ************************************************************************* The searchorder for global mailcap-files could configured on several ways. Edit "Lynx.cfg": 1. Specify files @{b}GLOBAL_MAILCAP:@{ub} Example: @{i}GLOBAL_MAILCAP:ENV:Mosaic/mailcap@{ui} or @{i}GLOBAL_MAILCAP:AmiTCP:db/mailcap ENV:Mosaic/mailcap@{ui} 2. Specify and Environment-variable which holds the files @{b}GLOBAL_MAILCAP:$@{ub} Example: In AmigaDOS: @{i}set MAILCAPS AmiTCP:db/mailcap ENV:Mosaic/mailcap In Lynx.cfg: @{i}GLOBAL_MAILCAP:$MAILCAPS@{ui} ENV:Mosaic/mailcap may have problems with SYS:Utilities/MultiView in form of interpreting the PUBSCREEN=BlaScreen-Option. I usually use mailcap-entries like @{i}text/x-aguide; sys:Utilities/MultiView %s PUBSCREEN=Mosaic@{ui} but this fails with ALynx when there is no pubscreen called "Mosaic". In this case, Multiview fails with returncode 8009. [not my fault 8(] A fast solution for this problem would be removing all PUBSCREEN= entries from mailcap. Solution from peterh@geko.com.au (Peter Hanrahan): (thanx'a'lot) > Also, I have a fix for the PUBSCREEN problem. I have found on my > systemn that I get a lot of problems when MUI makes or kills a > public screen, frequently locking the system up. I get around > this by using ScreenWizard (on Aminet). With this I can define a > public screen, and when a program looks for it, it is created. > This way MUI doesn't get to make the screen, and so I don't have > these problems. The other advantage is that when Alynx runs > multiview, Screenwizard will create the MOSAIC pubscreen for it, > a better solution than removing the pubscreen call. @endnode @node ENGLISH "gnafoo rabbeet kneek fata soo" ************************************************************************* * English * ************************************************************************* English isn't my native language but I'm willing to learn it 8) Please correct me if I'm wrong or use some offending words. [I once called a Screen-Tool "stool" ... 8) ] @endnode @node FILES "ls -R, list all, dir all" ************************************************************************* * ALynx - distribution-files * ************************************************************************* ReadMe.Amiga should get you right here ALynx executable ALynx_AS225 AS225-executable (C= TCP/IP or I-Net 225 ) ALynx.guide I don't remember @{"Lynx.cfg" link LYNXCFG} check this one for configuration jumps.html jumps-example CHANGES original Unix/VMS Lynx history ENV/Mosaic/mailcap mailcap example (copy to ENVARC:) ENV/Mosaic/mime.types mime.types example (copy to ENVARC:) about_lynx/about_lynx.html original about_lynx/readme.html original goodies/ReSize.lha handle COLS/LINES environment vars goodies/ReSize.readme goodies/Mosaic_Shunt.rexx modified shunt (Rexx) goodies/Nudel_MALS.LHA other shunt (AmigaDOS) goodies/Nudel_MALS.readme orig/#? some files which come with Unix/VMS Lynx lynx_help/lynx_help_main.html help main menu lynx_help/Lynx_users_guide.html lynx usersguide lynx_help/keystroke_commands/#? single helpfiles @endnode @node LYNXCFG "configure ? why ?" ************************************************************************* * lynx.cfg * ************************************************************************* The configurationfile "lynx.cfg" must be present in one of the following locations: 1. filename specified by "-cfg" commandline option 2. filename specified by env-variable "LYNX_CFG" 3. "AmiTCP:db/lynx.cfg" 4. "INET:db/lynx.cfg" 5. "PROGDIR:lynx.cfg" ************************************************************************* * Amiga entries in lynx.cfg * ************************************************************************* @{b}TEMPDIR@{ub}: TEMPDIR is the default directory for ALynx to store temporary files. Usually this is T:, but it could be set to some other space. BEWARE! If you set TEMPDIR to some directory on harddisk, this may corrupt your hard drive in case of a machinecrash. The directory MUST end with a colon ":" or slash "/" and it MUST exist. @{b}MAILCOMMAND@{ub}: MAILCOMMAND is the default command for ALynx to mail a textfile to the net. The file to be sent will be put behind this entry. ALynx itself inserts the "From:" and "To:"-headerstuff. You may add commandline options as needed. ADMail-example: (aminet:comm/mail by Simon Brown) @{i}MAILCOMMAND:ADMail@{ui} SMTPpost-example: (aminet:comm/net/INetUtils-1.4-AmiTCP) the line below will expand to "MAILCOMMAND:SMTPpost -f yourusername < T:L1297418400.html" @{i}MAILCOMMAND:SMTPpost -f $USER <@{ui} PutMail-example: (aminet:comm/net/PutMail*.lha) @{i}MAILCOMMAND:AmiTCP:bin/PutMail@{ui} @{b}DOWNLOADDIR@{ub}: DOWNLOADDIR is the default directory for ALynx to store downloaded files. On default this is $HOME, but it could be set to some other space. The directory MUST end with a colon ":" or slash "/" and it MUST exist. ex.:DOWNLOADDIR:DH1:files/freshdata You may also specify an environmentvariable like $DOWNDIR which holds the path.. It has to be set up externally. ENV-vars are marked with a leading '$'. You cannot use mixed vars/pathes. ex.: set USERDOWNDIR $HOME/downloads/ DOWNLOADDIR:$USERDOWNDIR @{i}for other keywords read file @{b}lynx.cfg@{ub}@{ui} @endnode @node FUN ALynx is an WWW oriented system to view and obtain textual HTML pages. From a websurfers point of view, using ALynx saves a lot of time and makes life much easier. Thinking about complicated terms like "delayed image loading" or "Guru alerts" is simply not neccesary. On the other hand, users of ALynx based WWW-connections have the ability to customize nearly every option of the programs interface according to their personal taste. This distribution is interesting for both, websurfers and surfwebbers. Please have a look at the supplied lynx.cfg and at the documentation to see what ALynx has to offer. @endnode @node INDEX "The Index" @{"AmiTCP.................." link NOTES} ALynx runs on AmiTCP @{"AS225..................." link NOTES} ALynx runs on AS225 @{"Author.................." link AUTHOR} Who wrote this @{"Betatester.............." link BETATESTER} How to supply bugreports @{"Bugreports.............." link BETATESTER} gimme gimme gimme @{"Colors.................." link COLORSETTINGS} In ANSI-Windows @{"Commands................" link COMMANDS} Some keyboard definitions @{"DOWNLOADDIR:............" link LYNXCFG} Lynx.cfg @{"Downloaddirs............" link PROBLEMS} FAQ @{"e-mail configuring......" link FAQ} Options-Menu @{"e-mail of author........" link AUTHOR} My e-mail adresses @{"ENV: variables.........." link ENVVARS} Some special ENV: variables @{"ENV:COLS setting........" link RESIZE} Number of columns to display in shellwindow @{"ENV:CURSESANSICOLORS...." link COLORSETTINGS} How to change colors on ANSI @{"ENV:CURSESTYPE ANSI....." link ENVVARS} Run ALynx in current Shellwindow @{"ENV:CURSESTYPE SCREEN..." link ENVVARS} Run ALynx on its own screen @{"ENV:HOME................" link PROBLEMS} FAQ @{"ENV:LINES setting......." link RESIZE} Number of lines to display in shellwindow @{"FAQs...................." link PROBLEMS} Frequently Asked Questions @{"Files..................." link FILES} List of distributed files @{"Goodies................." link GOODIES} List of other supplied programs/utilities @{"History-Buffer.........." link PROBLEMS} FAQ @{"History................." link HISTORY} The growing of ALynx @{"Hotlists of AMosaic....." link PROBLEMS} FAQ @{"I-Net 225..............." link NOTES} ALynx runs on I-Net 225 @{"IRC-Bot for ALynx......." link MAIN} Where to get ALynx on IRC @{"Keyboard................" link COMMANDS} Some keyboard definitions @{"Low on memory..........." link PROBLEMS} FAQ @{"Lynx.cfg location......." link ENVVARS} Setting via ENV:-var @{"Lynx.cfg................" link LYNXCFG} The configuration file, Amiga specials @{"mailcap................." link PROBENVMAILCAP} mailcap files: problems & where to search @{"MAILCOMMAND:............" link LYNXCFG} Lynx.cfg @{"MLink..................." link NOTES} ALynx runs on MLink @{"Money..................." link AUTHOR} Where to deposit your money @{"Mosaic_Shunt.rexx......." link GOODIES} Goodie @{"Notes..................." link NOTES} Some notes about ALynx @{"Nudel_MALS.lha.........." link GOODIES} Goodie @{"People.................." link HELPERS} People who helped with bugreports @{"Problems................" link PROBLEMS} Problems which may occur, Q&A section @{"Public screens.........." link SCREENSETTINGS} Run ALynx on its own screen @{"ReSize.................." link RESIZE} Utility to set LINES & COLS automagically @{"Saving files where ?...." link PROBLEMS} FAQ @{"Screenmodes............." link SCREENSETTINGS} Setting the desired screenmode @{"Screens................." link SCREENSETTINGS} Run ALynx on its own screen @{"Shuntprograms..........." link GOODIES} Inside archive @{"Starting ALynx.........." link USAGE} "Unknown command alynx" @{"TEMPDIR:................" link LYNXCFG} Lynx.cfg @{"Temporary files........." link LYNXCFG} Where to store them @{"Usage..................." link USAGE} How to start ALynx @{"What is it ?............" link DESCRIPTION} Small description of ALynx @{"WWW Homepage of ALynx..." link MAIN} Where to get ALynx on WWW @endnode @node HISTORY "...on the 7th day he ported ALynx" ************************************************************************* * History * ************************************************************************* Sun Oct 15 12:25:33 1995: @{b}ALynx_2.4-FM AmigaPort 1.31 (10/15/95)@{ub} - fixed enforcerhit on ftp abort. (reported by Troels Walsted Hansen ) - modified -term switch work like setenv CURSESTYPE. ex.: 1> alynx -term ansi www.foo.bar or : 1> alynx -term "screen 0x89024" ftp://localhost/stuff Wed Oct 11 22:04:19 1995 - fixed CLI argument/[G]oto URLs to handle local filepaths with assigns again. (reported by Heikki Kantola ) Tue Oct 3 21:26:22 1995: @{b}ALynx_2.4-FM AmigaPort 1.30 (10/03/95)@{ub} - refixed mail handling - btw. my e-mail has changed! Do NOT use wwwutz@tfh-berlin.de anymore. It's now "marquardt_p@mpimg-berlin-dahlem.mpg.de". "marquardt_p@fhi-berlin.mpg.de" is still valid, too! - fixed reference to usergroup.library for MLink'ers. No Requester should pop up anymore. MLink'ers still need usergroup.library. (reported by Wouwe van AP ) - short feature-list: prompted string editing, editing of titles when adding bookmarks, more documentation and help updates, -validate switch for anonymous users, -historical switch for comment handling, -nolist switch, better recovering from bad HTML, TEXTAREA handling like Netscape, STARTFILE/HOMEPAGE and 'g'oto URLs get converted "www.foo.com" -> "http://www.foo.com", ALT="" IMG tags handling, -link/traversal/crawl switch for automagically walk down all links on a page, send HEAD request key ']', -post_data, -get_data, -auth=ID:PASSWD, -mime_header, -noredir, nntp URL handling (readonly), etc etc etc. RTFM - no time for extensive testing, so lets bump revision, put this on the web and rely on these beta-test guys. Let's coredump my alynx pine-folder 8) Thu Aug 31 09:28:56 1995: - first compiled version - changed getstring behaviour to old ALynx style ([Del] deletes current char, [Backspace] moves left and erases) Wed Aug 30 19:38:56 1995: Tue Aug 29 20:13:51 1995: Mon Aug 28 20:16:01 1995: Sun Aug 27 13:38:56 1995: - applied Lynx 2.4-FM (08-24-95) patches o 38 patchfiles for the ALynx-executable-sources resulting in 538 patches: 44 deletions, 173 appends, 321 changes o 30 patchfiles for the www-library-sources resulting in 248 patches: 10 deletions, 78 appends, 160 changes - please read the file CHANGES for the new 2.4-FM (08-24-95)-features Sun Jul 23 14:59:57 1995: @{b}ALynx_2.4-FM AmigaPort 1.29 (07/23/95)@{ub} - added Josef Faulkners rexx-mail client for AmiTCP - no more bugreports since 1.28 which require Amigaport fixes (other HTML-depended bugs must be fixed by Unix/VMS-Lynx) - release this one on Aminet (comm/net) Thu Jul 20 17:38:39 1995: - added goodies/copystripper.rexx for saving files to different destination directories on some BBS setups - another enforcerhit removed on ftp-abort (i begin to hate unix 8) Mon Jul 17 18:53:37 1995: @{b}ALynx_2.4-FM AmigaPort 1.28 (07/18/95)@{ub} - initialise DOWNLOADDIR to $HOME if not properly set up in lynx.cfg - DOWNLOADDIR: in lynx.cfg now also accepts ENV-vars - someone in news dared to compare ALynx' filesize with AMosaic 8) - added ENV-var support for mailcap files. - added Index to ALynx.guide Fri Jul 14 21:08:30 1995: @{b}ALynx_2.4-FM AmigaPort 1.27 (07/14/95)@{ub} - fixed address error on 68000 Amigas (thanks go to Leo Davidson && Matthias Barnutz for mailing snapshot files) - fixed enforcerhits on ftp-abort [someone should port enforcer to Unix & VMS 8-) ] - added some spaces to "print to mail" header - updated the guide Fri Jul 7 13:54:31 1995: @{b}ALynx_2.4-FM AmigaPort 1.26 (07/07/95)@{ub} - applied Lynx 2.4-FM (07-05-95) patches o 25 patchfiles for the ALynx-executable-sources resulting in 220 patches: 22 deletions, 97 appends, 101 changes o 7 patchfiles for the www-library-sources resulting in 50 patches: 0 deletions, 13 appends, 37 changes - please read the file CHANGES for the new 2.4-FM (07-05-95)-features - short: Netscape extensions (CENTER, BLINK, LEFT, RIGHT, ALIGN), treat '>' as both a close-double-quote and close-tag, [L]ists indicate the anchor NAME/ID if present, enable creation of links for all images (MAKE_LINKS_FOR_ALL_IMAGES in lynx.cfg, -image_links), LYK_IMAGE_TOGGLE-Key [*], downloadsstuff,

-stuff, bad HTML-stuff, TABLE form processing, Don't show "[INLINE]" (Key-[, lynx.cfg: MAKE_PSEUDO_ALTS_FOR_INLINES, CLI: -pseudo_inlines),

, connect() and select() bumped to 30,000 tries, etc. etc. etc. - "Save to disk" now displays configured path or $HOME Wed Jul 5 14:58:12 1995: @{b}ALynx_2.4-FM AmigaPort 1.25 (07/02/95)@{ub} - discovered some weird bugs in curses.lib - fixed curses.lib not to scroll consolewindow if a character is placed to position (COLS,LINES) (rightmost, lowest line). This might cause trouble with BBS-Installations. Please report, if weird or no scrolling occurs. - removed all XWINDOWS-dependecies. If someone needs them, i'll reimplement them. Just mail me 8) - fixed colour-trouble on getstring() - fixed options menu. input couldn't be deleted Mon Jul 3 03:56:17 1995: - "save to disk" (D-Key) now saves to $HOME only, to allow other save- methods, use DOWNLOADER: option in "lynx.cfg" ! (enabled by default) Sun Jul 2 16:20:46 1995: - applied Lynx 2.4-FM (06-25-95) patches o 20 patchfiles for the ALynx-executable-sources resulting in 92 patches o 1 patchfile for the www-library-sources resulting in 59 patches - please read the file CHANGES for the new 2.4-FM (06-08-95)-features - short: new [L]ist command for creating an ACTIVATEable list of references (links) in the current document, DTD structures, forms DISABLED attribute, INPUT type "scribble", all ISO8859-1 entities, FIG handling, onlinehelp HTML fixed, BQ, CAPTION, CREDIT, FIG, NOTE and OVERLAY structures, (HTML 3.0-stuff), etc etc. - shortened some sleep()-calls from 2 to 1 seconds - added check on existance of $HOME variable Sun Jun 25 12:59:07 1995: @{b}ALynx_2.4 AmigaPort 1.24 (06/10/95) AS225@{ub} - finished AS225 version - added more types to ENV/Mosaic/mime.types Sat Jun 24 20:27:03 1995 - working on AS225 version Tue Jun 13 12:18:50 1995 - turned off requesters on local file access Sat Jun 10 16:22:12 1995: @{b}ALynx_2.4 AmigaPort 1.24 (06/10/95)@{ub} - applied Lynx 2.4 (06-08-95) patches (see CHANGES in dir "orig/") - lynx.cfg-path configurable by env-variable - cleaned up ALynx.guide - resorted history - created new ALynx/ distribution archive - caution! files in "help_files" don't exist anymore! path has changed to "lynx_help". please delete old path. - fixed double headers in mail Fri Jun 9 12:43:08 1995: - applied Lynx 2.3-FM (05-29-95) patches Wed Jun 7 22:42:19 1995: @{b}ALynx_2.3-FM AmigaPort 1.23 (06/07/95)@{ub} - fixed reintroduced "optionsave-disabled"-bug Mon Jun 5 19:56:21 1995: @{b}ALynx_2.3-FM AmigaPort 1.22 (06/05/95)@{ub} - fixed filename-quoting Mon Jun 5 14:14:12 1995: @{b}ALynx_2.3-FM AmigaPort 1.21 (06/05/95)@{ub} - emergency-fix copy-command in download-menu Sun Jun 4 12:07:54 1995: @{b}ALynx_2.3-FM AmigaPort 1.20 (06/04/95)@{ub} - fixed transfer abort (Z-key), shouldn't lock up anymore - fixed mail - fixed document-refresh (^R-key) Sat Jun 3 12:10:25 1995 - fixed temporary filenames created by mail Fri Jun 2 15:43:37 1995: @{b}ALynx_2.3-FM AmigaPort 1.19 (06/02/95)@{ub} - refixed commandline-supplied URLs for local files - fixed -homepage= option - yup, release it now. Thu Jun 1 13:20:49 1995 - fixed mail/mail-comments - added MAILCOMMAND: in lynx.cfg to configure executable for mails - lynx.cfg has new entries (BOLD_HEADERS,*_proxy,NO_DOT_FILES, GLOBAL_EXTENSION_MAP,PERSONAL_EXTENSION_MAP,MAILCOMMAND) - ReSize 1.2 put in distribution - refixed socket-connect Wed May 31 18:03:07 1995: @{b}ALynx_2.3-FM AmigaPort 1.18 (05/31/95)@{ub} o 61 patchfiles for the ALynx-executable-sources resulting in 797 patches: 43 deletions, 259 appends, 496 changes Sun May 21 12:40:36 1995 - upgrade to Lynx 2.3-FM please read the file CHANGES for the new 2.3-FM-features short: ftp, search within document, -show_cursor, LYK_REMOVE, memory leak fixes, -cfg switch, href parsing, -selective, -nobrowse, -localhost, Accept-Language headers, proxy via lynx.cfg, etc etc etc. o 24 patchfiles for the www-library-sources resulting in 311 patches: 15 deletions, 114 appends, 182 changes Mon May 15 13:15:34 1995: - cleaner statusline with weird https (found them on Spumonis webpages 8) Sat May 13 15:32:25 1995 - added TEMPDIR: in Lynx.cfg for low-mem-users Thu May 11 18:16:19 1995: @{b}ALynx_2.3.7 AmigaPort 1.17 (05/11/95)@{ub} - emergency-fix on forms-input Wed May 10 11:56:50 1995: @{b}ALynx_2.3.7 AmigaPort 1.16 (05/10/95)@{ub} - fixed Jump-feature (jumpfile wasn't closed, etc) - I nearly got braindead on sc.lib:stat(). better use usr.lib:stat() - i found several problems with incorrect html-files. Don't know how to fix them. - several people reported bugs like "**** HTAccess: Internal software error.". This might got fixed with 2.3.7. Please check. - added PRINTER:-entry in lynx.cfg - small errorchecks in ReadCfg() Tue May 9 18:53:22 1995: @{b}ALynx_2.3.7 AmigaPort 1.15 (05/09/95)@{ub} - fixed ANSI-Mode-"run NIL: ALynx"-bug (reported by N'Kognito) (yup, this isn't very usual, but it crashed 8) - refixed options-screen - reapplied some patches, which got lost on my saturday patch-session - fixed NULL-pointer strcmp()-bug for homepage (M-key) (Hey! SAS/cpr/Enforcer/findhit should be ported to VMS/Unix 8) - fixed typo in "help_files/keystroke_commands/keystroke_help.html" (this should bump the versionnumber to ALynx'95 ;-) ) - made new "show-keymap" (K-key) work - "remove from bookmark" now works again - refixed options-popup-form (my box() is nicer 8-) - lynx.cfg wasn't closed after reading. Sun May 7 20:26:15 1995: @{b}ALynx_2.3.7 AmigaPort 1.14 (05/07/95)@{ub} - yup, released it now. Sat May 6 14:03:01 1995: @{b}ALynx_2.3.7 upgrade@{ub} - I just discovered that I ported Lynx 2.3.0 . Ok, this IS hard work. - created/modified o 80 patchfiles for the www-library resulting in 448 patches: 37 deletions, 210 appends, 201 changes 105 sourcefiles with approx. 980 kb o 48 patchfiles for the ALynx-executable resulting in 890 patches: 54 deletions, 267 appends, 569 changes 81 sourcefiles with approx. 600 kb o including curses.lib (85 files/180kb) the overall needed sources add to ~270 sourcefiles with 1.7 MB 8)) - this heavy patching might introduce new AND old bugs but there are lotsa bugs fixed (concerning the HTML-stuff) - cleaned up BOOL vs BOOLEAN - refixed "looping-bug" (Unix-Lynx still has this one 8) ) - fixed Version-strings (User-Agent: field) (Thanks Mike Meyer) - updated the distribution-archive - the ALynx-Homepage has been fixed to support lha-files. (Thnx Vito) Fri Apr 28 20:04:06 1995: @{b}ALynx_2.3 AmigaPort 1.13 (04/29/95)@{ub} - fixed scrolling-bug in ansi-mode in options-statusline - small layout-fixes - NEW getstringfunction. now allows cursorediting. Wed Apr 26 15:38:30 1995: @{b}ALynx_2.3 AmigaPort 1.12 (04/26/95)@{ub} - curses.lib now supports MAXLINES ($LINES) upto 250. - added support of public-screens and screenmodes (see ENV:CURSESTYPE) - no "Please insert Volume INET:..." anymore. (Thnx ZZA) Fri Apr 21 20:02:01 1995: @{b}ALynx_2.3 AmigaPort 1.11 (04/21/95)@{ub} - ARGH! found a bug concernig COLS > 80 && CURSESTYPE = SCREEN - fixed domain-problem (fixed it the hard way 8) - hopefully fixed the "optionsave-disabled"-bug 8) (and other related stuff) Fri Apr 21 15:52:18 1995: @{b}ALynx_2.3 AmigaPort 1.10 (04/21/95)@{ub} ( my birthday-release 8)) ) - created "ReSize"-tool to set local/global env-vars for COLS & LINES (can be found in ReSize.lha in this distribution) - curses.lib now supports MAXCOLUMNS ($COLS) upto 160 - finally found this annoying "looping"-bug. Don't close(0)! [same procedure as every bug, james: "not my fault 8)"] - fixed badly set '\\n' on alerts Wed Apr 19 21:08:09 1995: - fixed loading/saving of "ncsa-xmosaic-hotlist-format-1"-bookmarks now it is possible to use AMosaic's bookmark/hotlist-files: just insert "bookmark_file=envarc:mosaic/.mosaic-hotlist-default" in ".lynxrc" or "lynx.cfg". Thanks XS. Tue Apr 18 15:54:59 1995: @{b}ALynx_2.3 AmigaPort 1.9 (04/18/95)@{ub} - argparsing for local files fixed. "ALynx SYS:foo/bar.html" now works fine. There still will be problems on filenames like "FILE://blah/blush.html". (Assignment "file:" + 2 dirs up + down 1 dir "bla" + file "blush.html")... who cares 8) - fixed HD-crash of my 120 MB source-partition. phew! - fixed several stringoverflows on strncpy() - hopefully fixed the "looping"-bug Mon Apr 17 14:35:23 1995: @{b}ALynx_2.3 AmigaPort 1.8 (04/17/95)@{ub} - fixed bad scrolling on multi-popupoptions - tolower(URL) in HTParse wasn't such a good idea - print to file now works - print to screen now works - fixed bad SAS/C getenv()-behaviour (thnx Tau) Sun Apr 16 15:23:38 1995: @{b}ALynx_2.3 AmigaPort 1.7 (04/16/95)@{ub} - finally found colorbug in curseslib. fixed it. - fixed another '\\n'-related bug in curseslib. (hmmm, does anyone know, how to display the backslash in an amigaguide-document ?????) - cleaned up colors ANSI-mode Screen-mode ------------------------------------------------ text: [0m (WB-black) white bold: [32m (WB-greyblue) yellow link: [33m (WB-white) green since now, it is only possible to change ansicolors for bold/links. (ENV:CURSESANSICOLORS). this will be done in future by .lynxrc! More colors/attributes to come! Sat Apr 15 16:44:27 1995: - (internal) added some prototypes - added colorsupport and revealed nasty curses-colorbug Sat Apr 15 01:00:23 1995: - added new SAS 6.55-ENV:TZ-code Fri Apr 14 14:51:13 1995: @{b}ALynx_2.3 AmigaPort 1.6 (04/14/95)@{ub} - lynx.cfg searchorder: "AMITCP:db/" -> "INET:db/" -> "PROGDIR:" - hopefully fixed wgetch()-looping-problem - fixed pathname on download (D-key) - argh. New HTParse.c (thanks Michael) cleaned the URL to lowercase the hostname. This also converted "LYNXDOWNLOAD://Method=-1" to "LYNXDOWNLOAD://method=-1". Well... strstr(line,"Method=") didn't like that 8) - added filename-checks on user-defined local-filenames - download (D-key) seems to work now - fixed typo on -restrictions= helplist. must be "option_save" (still can't find the "options-save disabled"-bug) - abort transfer now works (Z or ^G) - oops. there is no "/bin/rm" is it ? 8)) Wed Apr 12 21:08:15 1995: @{b}ALynx_2.3 AmigaPort 1.5 (04/12/95)@{ub} - fixed pathname for strcat($HOME,".lynxrc") - fixed same problem at several other places. Replaced them with dos.library\\AddPart() - emergency-fix on "block cut'n'copy"-typo Wed Apr 12 19:09:51 1995: @{b}ALynx_2.3 AmigaPort 1.4 (04/12/95)@{ub} - fixed some versionstrings - stacksize automagically bumped to 10000 bytes - cleaned some code Tue Apr 11 04:01:06 1995: - fixed control-R-refresh - fixed History-Page-URL (backspace-key) - fixed Information-Page-URL (=-key) - fixed Printing-Options-Page-URL (P-key) Tue Apr 11 01:50:41 1995: @{b}ALynx_2.3 AmigaPort 1.3 (04/10/95)@{ub} - finally found the external bug. curses.lib didn't support endwin/initscr-sequences. Mon Apr 10 14:17:59 1995: @{b}ALynx_2.3 AmigaPort 1.2 (04/10/95)@{ub} - fixed cursor-hiding in lower right corner (N`Kognito@#amiga.IRC) - changed the default-curses-startup to ANSI. - added ENV:CURSESANSICOLORS to map certain colors in the shellwindow - lynx.cfg first searched in "AMITCP:db/" on failure in "PROGDIR:" - ReadMe.Amiga moved to ALynx.guide - Kludge in libwww to work with local files. Has ANYBODY a ported libwww by hand, which handles URLs like "file://localhost/S:startup-sequence" ? Any hints welcome. - added AmigaDos-$VER-string Sun Apr 9 16:48:48 1995: @{b}ALynx_2.3 AmigaPort 1.1 (04/09/95)@{ub} First Beta-beta-beta-test-Release on IRC ************************************************************** The first to report where @{"this" link FUN} is from gets mentioned here 8) ************************************************************** @endnode