File: MAINTENANCE

package info (click to toggle)
libcurses-perl 1.28-1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze, wheezy
  • size: 888 kB
  • ctags: 1,323
  • sloc: ansic: 8,743; perl: 1,298; makefile: 7
file content (77 lines) | stat: -rw-r--r-- 2,519 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
These are notes for the maintainer.

Steps to release:

  - Test the build:

    make realclean
    Set up environment variables, c-config.h if required.
    perl Makefile.PL PANELS MENUS FORMS
    make
    perl -Mblib -MCurses -e1

  - make realclean

  - Update HISTORY file with description of new stuff and release date.

  - Update version number in Curses.pm (search for VERSION).

  - Make a tarball with something like this:

    tar --file=/tmp/Curses-1.07.tgz --gzip --create Curses-1.07

  - Upload via pause.perl.org.  Use "upload a file to CPAN" link.
    You have to login to make that link appear.

    It goes into CPAN in the directory belonging to the user who
    uploaded it.  PAUSE gives you various options for uploading, tells
    you how to follow the progress of the uploading and indexing, and
    sends you emails about it.

  - PAUSE will automatically extract the README file from the tarball
    and install it as e.g. Curses-1.07.readme

  - PAUSE will open the tarball automatically and index the packages it finds
    in there by name (Curses::Window, Curses::Screen, etc.).


For Bryan's test system:

  export CURSES_LDFLAGS="-L/usr/link/ncurses -lncurses -ldl"
  export CURSES_CFLAGS="-I/usr/include/ncurses"


GEN
---

The package is designed to have all the distributed code files
(Curses.pm, CursesFun.c, etc.) generated by the programs in gen.tar .
This is supposed to handle the myriad Ncurses functions with less
tedium than manually editing the files.

However, Bryan doesn't know how the Gen stuff works, so he has been
making the small updates necessary directly to the distributed files.
But the changes are modest, so it should be possible some day to
generate new files, diff to see what changed, and put those changes
into the Gen programs.

Originally, what is in gen.tar was a directory name 'gen' in the Curses
package on CPAN, and CPAN unfortunately indexes the Perl modules in there as
public modules.  And because make.Curses.pm contains the perldoc stuff for
Curses.pm, people have even been mislead into using that unmaintained file
for documentation of the functions in Curses.pm.

Since I don't know how to stop CPAN from doing that, I solved that problem
by tarring up the directory.


ppport.h
--------

You generate this by running the function Devel::PPPort::WriteFile().

There shouldn't be any need to generate a new one unless there are
updates to the Devel::PPPort package.

A comment in ppport.h says it was generated by Perl 5.006002.  That's
a lie.