$Id: README.txt,v 1.2 2005/11/14 03:21:43 syscrusher Exp $

This is the experimental beginning of what will eventually become a "links
management bundle", a collection of several modules to facilitate URL
handling in Drupal nodes.

This module is under very active development, and is NOT yet ready for
production release. At this time, it is considered to be ALPHA TEST quality.


                         MODULE DESCRIPTIONS

LINKS

  links.module provides an application program interface (API) for managing
  internal and external links as part of a Drupal node. The module by itself
  does very little; mainly, it provides a user interface for controlling the
  way in which links are handled and how they behave within all nodes -- in
  other words, the global settings for the API library.

  Author:  Scott Courtney (drupal.org user "syscrusher")

  RELEASE STATUS: This is EXPERIMENTAL code; do not use in production sites.

LINKS_RELATED

  links_related.module allows nodes of arbitrary types (as designated by the
  site administrator) to have one or more associated links to related
  content.

  Author:  Scott Courtney (drupal.org user "syscrusher")

  RELEASE STATUS: This is EXPERIMENTAL code; do not use in production sites.

LINKS_WEBLINK

  links_weblink.module is a modified version of the existing weblink.module,
  but uses the new links API and database tables.

  RELEASE STATUS: This is EXPERIMENTAL code; do not use in production sites.



                           UPDATE SCRIPTS

To run the update scripts, you must first use the regular Drupal ugrade
procedure to convert your {node} table (and related tables) to version 4.6
The update scripts will NOT work with Drupal 4.5; neither will the links
bundle.

THE UPDATE SCRIPTS ARE EXPERIMENTAL -- Use at your own risk.

update-weblinks-old.php

  If you have weblink nodes that were created before Drupal 4.6, this is the
  update script that you need. It non-destructively copies data from the old
  {weblink} table into the new combination of {links} and {links_node}
  using the API calls to correctly normalize each URL. (It is *not* correct
  to simply use SQL commands to directly copy the URLs from the old table to
  the new ones.)

update-webstory.php

  The module "webstory" was developed for use on a few specific sites. Chances
  are about 99% that you are not using webstory.module and therefore do not
  need this script. It's provided as an example, however, in case it might
  be useful to other developers.