ftp://ftp.sunet.se/pub/vendor/sco/skunkware/osr5/x11/savers/xscreensaver/xscreensaver...
[xscreensaver] / local / man / cat.1 / webcollage.1
diff --git a/local/man/cat.1/webcollage.1 b/local/man/cat.1/webcollage.1
new file mode 100644 (file)
index 0000000..e023479
--- /dev/null
@@ -0,0 +1,198 @@
+
+
+
+XScreenSaver(1)                                   XScreenSaver(1)
+
+
+N\bNA\bAM\bME\bE
+       webcollage  -  decorate the screen with random images from
+       the web
+
+S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
+       w\bwe\beb\bbc\bco\bol\bll\bla\bag\bge\be [-display _\bh_\bo_\bs_\bt_\b:_\bd_\bi_\bs_\bp_\bl_\ba_\by_\b._\bs_\bc_\br_\be_\be_\bn]  [-root]  [-ver-
+       bose]  [-delay  _\bs_\be_\bc_\bs]  [-timeout  _\bs_\be_\bc_\bs]  [-background  _\bb_\bg]
+       [-filter _\bc_\bo_\bm_\bm_\ba_\bn_\bd] [-filter2 _\bc_\bo_\bm_\bm_\ba_\bn_\bd]
+
+D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
+       The _\bw_\be_\bb_\bc_\bo_\bl_\bl_\ba_\bg_\be program pulls random image off of the World
+       Wide  Web  and scatters them on the root window.  It finds
+       these images by doing random web searches, and  extracting
+       images  from  the returned pages.  It places the images on
+       the root window  by  using  the  x\bxv\bv(1),  g\bgi\bif\bft\bto\bop\bpn\bnm\bm(1),  and
+       d\bdj\bjp\bpe\beg\bg(1) tools.
+
+       _\bw_\be_\bb_\bc_\bo_\bl_\bl_\ba_\bg_\be also works as a CGI program: simply make a sym-
+       bolic link to the _\bw_\be_\bb_\bc_\bo_\bl_\bl_\ba_\bg_\be executable called _\bn_\bp_\bh_\b-_\bw_\be_\bb_\bc_\bo_\bl_\b-
+       _\bl_\ba_\bg_\be_\b._\bc_\bg_\bi.   If this program sees that it is being run as a
+       CGI, then it will behave  appropriately.   (The  generated
+       web  page  will  list the images one after another, rather
+       than tiling them together.)
+
+       _\bw_\be_\bb_\bc_\bo_\bl_\bl_\ba_\bg_\be is written in p\bpe\ber\brl\bl(1) and requires Perl 5.
+
+O\bOP\bPT\bTI\bIO\bON\bNS\bS
+       _\bw_\be_\bb_\bc_\bo_\bl_\bl_\ba_\bg_\be accepts the following options:
+
+       -\b-r\bro\boo\bot\bt   Draw on the root window.  This  option  is  mandi-
+               tory: drawing to a window other than the root win-
+               dow is not yet supported.
+
+       -\b-v\bve\ber\brb\bbo\bos\bse\be or -\b-v\bv
+               Print diagnostics to stderr.  Multiple _\b-_\bv switches
+               increase  the amount of output.  _\b-_\bv will print out
+               only the URLs of the images; _\b-_\bv_\bv  will  print  all
+               the  commands  being run; and _\b-_\bv_\bv_\bv will print more
+               than you care about.
+
+       -\b-d\bde\bel\bla\bay\by _\bs_\be_\bc_\bo_\bn_\bd_\bs
+               How long to sleep between images.  Default 1  sec-
+               ond.   (Remember that this program probably spends
+               a lot of time waiting for the network.)
+
+       -\b-b\bba\bac\bck\bkg\bgr\bro\bou\bun\bnd\bd _\bc_\bo_\bl_\bo_\br_\b-_\bo_\br_\b-_\bp_\bp_\bm
+               What to use for the background onto  which  images
+               are pasted.  This may be a color name, a hexadeci-
+               mal RGB specification in the  form  '#rrggbb',  or
+               the name of a PPM file.
+
+       -\b-t\bti\bim\bme\beo\bou\but\bt _\bs_\be_\bc_\bo_\bn_\bd_\bs
+               How long to wait for a URL to complete before giv-
+               ing up on it  and  moving  on  to  the  next  one.
+
+
+
+X Version 11                17-Jun-99                           1
+
+
+
+
+
+XScreenSaver(1)                                   XScreenSaver(1)
+
+
+               Default 30 seconds.
+
+       -\b-f\bfi\bil\blt\bte\ber\br _\bc_\bo_\bm_\bm_\ba_\bn_\bd
+               Filter  all  source  images  through this command.
+               The command must take a PPM  file  on  stdin,  and
+               write  a  new PPM file to stdout.  One good choice
+               for a filter would be:
+
+                    webcollage -root -filter 'vidwhacker -stdin -stdout'
+
+
+       -\b-f\bfi\bil\blt\bte\ber\br2\b2 _\bc_\bo_\bm_\bm_\ba_\bn_\bd
+               Filter the _\bc_\bo_\bm_\bp_\bo_\bs_\bi_\bt_\be image through  this  command.
+               The  _\b-_\bf_\bi_\bl_\bt_\be_\br option applies to the sub-images; the
+               _\b-_\bf_\bi_\bl_\bt_\be_\br_\b2 applies to the final, full-screen  image.
+
+E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
+       D\bDI\bIS\bSP\bPL\bLA\bAY\bY to get the default host and display number.
+
+       X\bXE\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
+               to  get the name of a resource file that overrides
+               the global resources stored in  the  RESOURCE_MAN-
+               AGER property.
+
+F\bFI\bIL\bLE\bES\bS A\bAN\bND\bD U\bUR\bRL\bLS\bS
+       _\b/_\bu_\bs_\br_\b/_\bd_\bi_\bc_\bt_\b/_\bw_\bo_\br_\bd_\bs or _\b/_\bu_\bs_\br_\b/_\bs_\bh_\ba_\br_\be_\b/_\bl_\bi_\bb_\b/_\bd_\bi_\bc_\bt_\b/_\bw_\bo_\br_\bd_\bs
+              To find the random words to feed to search engines.
+
+       _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\br_\ba_\bn_\bd_\bo_\bm_\b._\by_\ba_\bh_\bo_\bo_\b._\bc_\bo_\bm_\b/_\bb_\bi_\bn_\b/_\br_\by_\bl_\b,
+       _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bi_\bm_\ba_\bg_\be_\b._\ba_\bl_\bt_\ba_\bv_\bi_\bs_\bt_\ba_\b._\bc_\bo_\bm_\b/ To find random web pages.
+
+B\bBU\bUG\bGS\bS
+       When  drawing  on  the  root  window,  it  always uses the
+       default colormap.  This is actually a  limitation  of  xv.
+       But regardless, when using this program with xscreensaver,
+       it must be given the d\bde\bef\bfa\bau\bul\blt\bt-\b-n\bn visual  specification  (see
+       the x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1) manual for more details.)
+
+       Only the GIF and JPEG image formats are supported.
+
+       Transparent and animating GIFs are not supported.
+
+       It's slow.
+
+S\bSE\bEE\bE A\bAL\bLS\bSO\bO
+       X\bX(1),  x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1), x\bxv\bv(1), g\bgi\bif\bft\bto\bop\bpn\bnm\bm(1), d\bdj\bjp\bpe\beg\bg(1), v\bvi\bid\bd-\b-
+       w\bwh\bha\bac\bck\bke\ber\br(1), p\bpe\ber\brl\bl(1)
+
+C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT
+       Copyright (C) 1998, 1999 by Jamie Zawinski.  Permission to
+       use,  copy, modify, distribute, and sell this software and
+       its documentation for any purpose is hereby granted  with-
+       out  fee,  provided that the above copyright notice appear
+       in all copies and that both that copyright notice and this
+
+
+
+X Version 11                17-Jun-99                           2
+
+
+
+
+
+XScreenSaver(1)                                   XScreenSaver(1)
+
+
+       permission  notice appear in supporting documentation.  No
+       representations are made about  the  suitability  of  this
+       software  for any purpose.  It is provided "as is" without
+       express or implied warranty.
+
+A\bAU\bUT\bTH\bHO\bOR\bR
+       Jamie Zawinski <jwz@jwz.org>, 24-May-98.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+X Version 11                17-Jun-99                           3
+
+