doc/webserver/developer-manual/newrelease.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >Releasing a New Version</TITLE
   5 ><META
   6 NAME="GENERATOR"
   7 CONTENT="Modular DocBook HTML Stylesheet Version 1.64
   8 "><LINK
   9 REL="HOME"
  10 TITLE="Privoxy Developer Manual"
  11 HREF="index.html"><LINK
  12 REL="PREVIOUS"
  13 TITLE="Testing Guidelines"
  14 HREF="testing.html"><LINK
  15 REL="NEXT"
  16 TITLE="Update the Webserver"
  17 HREF="webserver-update.html"><LINK
  18 REL="STYLESHEET"
  19 TYPE="text/css"
  20 HREF="../p_doc.css"></HEAD
  21 ><BODY
  22 CLASS="SECT1"
  23 BGCOLOR="#EEEEEE"
  24 TEXT="#000000"
  25 LINK="#0000FF"
  26 VLINK="#840084"
  27 ALINK="#0000FF"
  28 ><DIV
  29 CLASS="NAVHEADER"
  30 ><TABLE
  31 WIDTH="100%"
  32 BORDER="0"
  33 CELLPADDING="0"
  34 CELLSPACING="0"
  35 ><TR
  36 ><TH
  37 COLSPAN="3"
  38 ALIGN="center"
  39 >Privoxy Developer Manual</TH
  40 ></TR
  41 ><TR
  42 ><TD
  43 WIDTH="10%"
  44 ALIGN="left"
  45 VALIGN="bottom"
  46 ><A
  47 HREF="testing.html"
  48 >Prev</A
  49 ></TD
  50 ><TD
  51 WIDTH="80%"
  52 ALIGN="center"
  53 VALIGN="bottom"
  54 ></TD
  55 ><TD
  56 WIDTH="10%"
  57 ALIGN="right"
  58 VALIGN="bottom"
  59 ><A
  60 HREF="webserver-update.html"
  61 >Next</A
  62 ></TD
  63 ></TR
  64 ></TABLE
  65 ><HR
  66 ALIGN="LEFT"
  67 WIDTH="100%"></DIV
  68 ><DIV
  69 CLASS="SECT1"
  70 ><H1
  71 CLASS="SECT1"
  72 ><A
  73 NAME="NEWRELEASE"
  74 >8. Releasing a New Version</A
  75 ></H1
  76 ><P
  77 >        When we release versions of <SPAN
  78 CLASS="APPLICATION"
  79 >Privoxy</SPAN
  80 >,
  81         our work leaves our cozy secret lab and has to work in the cold
  82         RealWorld[tm]. Once it is released, there is no way to call it
  83         back, so it is very important that great care is taken to ensure
  84         that everything runs fine, and not to introduce problems in the
  85         very last minute.
  86     </P
  87 ><P
  88 >        So when releasing a new version, please adhere exactly to the
  89         procedure outlined in this chapter.
  90     </P
  91 ><P
  92 >       The following programs are required to follow this process:
  93         <TT
  94 CLASS="FILENAME"
  95 >ncftpput</TT
  96 > (ncftp), <TT
  97 CLASS="FILENAME"
  98 >scp, ssh</TT
  99 > (ssh),
 100         <TT
 101 CLASS="FILENAME"
 102 >gmake</TT
 103 > (GNU's version of make), autoconf, cvs.
 104     </P
 105 ><P
 106 >        In the following text, replace X, Y and Z with the actual version number
 107         (X = major, Y = minor, Z = point):
 108     </P
 109 ><DIV
 110 CLASS="SECT2"
 111 ><H2
 112 CLASS="SECT2"
 113 ><A
 114 NAME="BEFORERELEASE"
 115 >8.1. Before the Release</A
 116 ></H2
 117 ><P
 118 >       The following <I
 119 CLASS="EMPHASIS"
 120 >must be done by one of the
 121        developers</I
 122 > prior to each new release.
 123      </P
 124 ><P
 125 >      <P
 126 ></P
 127 ><UL
 128 ><LI
 129 ><P
 130 >         Make sure that everybody who has worked on the code in the last
 131          couple of days has had a chance to yell <SPAN
 132 CLASS="QUOTE"
 133 >"no!"</SPAN
 134 > in case
 135          they have pending changes/fixes in their pipelines.
 136         </P
 137 ></LI
 138 ><LI
 139 ><P
 140 >         Increment the version number and increase or reset the RPM release number
 141          in <TT
 142 CLASS="FILENAME"
 143 >configure.in</TT
 144 > as appropriate.
 145        </P
 146 ></LI
 147 ><LI
 148 ><P
 149 >        If the default <TT
 150 CLASS="FILENAME"
 151 >actionsfile</TT
 152 > has changed since last
 153         release, bump up its version info in this line:
 154        </P
 155 ><P
 156 >
 157         <TABLE
 158 BORDER="0"
 159 BGCOLOR="#E0E0E0"
 160 WIDTH="90%"
 161 ><TR
 162 ><TD
 163 ><PRE
 164 CLASS="PROGRAMLISTING"
 165 >  {+add-header{X-Actions-File-Version: A.B} -filter -no-popups}
 166         </PRE
 167 ></TD
 168 ></TR
 169 ></TABLE
 170 >
 171        </P
 172 ><P
 173 >
 174         Then change the version info in doc/webserver/actions/index.php,
 175         line: '$required_actions_file_version = "A.B";'
 176        </P
 177 ></LI
 178 ><LI
 179 ><P
 180 >        If the HTML documentation is not in sync with the SGML sources
 181         you need to regenerate it. (If in doubt, just do it.) See the
 182         Section "Updating the webserver" in this manual for details.
 183        </P
 184 ></LI
 185 ><LI
 186 ><P
 187 >        <I
 188 CLASS="EMPHASIS"
 189 >Commit all files that were changed in the above steps!</I
 190 >
 191        </P
 192 ></LI
 193 ><LI
 194 ><P
 195 >        Tag all files in CVS with the version number with
 196         <SPAN
 197 CLASS="QUOTE"
 198 >"<B
 199 CLASS="COMMAND"
 200 >cvs tag v_X_Y_Z</B
 201 >"</SPAN
 202 >.
 203         Don't use vX_Y_Z, ver_X_Y_Z, v_X.Y.Z (won't work) etc.
 204        </P
 205 ></LI
 206 ></UL
 207 >
 208      </P
 209 ></DIV
 210 ><DIV
 211 CLASS="SECT2"
 212 ><H2
 213 CLASS="SECT2"
 214 ><A
 215 NAME="THERELEASE"
 216 >8.2. Building and Releasing the Packages</A
 217 ></H2
 218 ><P
 219 >      Now the individual packages can be built and released. Note that for
 220       GPL reasons the first package to be released is always the source tarball.
 221      </P
 222 ><P
 223 >      For <I
 224 CLASS="EMPHASIS"
 225 >all</I
 226 > types of packages, including the source tarball,
 227       <I
 228 CLASS="EMPHASIS"
 229 >you must make sure that you build from clean sources by exporting
 230       the right version from CVS into an empty directory:</I
 231 >.
 232      </P
 233 ><P
 234 >      <TABLE
 235 BORDER="0"
 236 BGCOLOR="#E0E0E0"
 237 WIDTH="100%"
 238 ><TR
 239 ><TD
 240 ><PRE
 241 CLASS="PROGRAMLISTING"
 242 >  mkdir dist # delete or choose different name if it already exists
 243   cd dist
 244   cvs -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa login
 245   cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa export -r v_X_Y_Z current
 246      </PRE
 247 ></TD
 248 ></TR
 249 ></TABLE
 250 >
 251     </P
 252 ><P
 253 >     <I
 254 CLASS="EMPHASIS"
 255 >Do NOT change</I
 256 > a single bit, including, but not limited to
 257      version information after export from CVS. This is to make sure that
 258      all release packages, and with them, all future bug reports, are based
 259      on exactly the same code.
 260     </P
 261 ><P
 262 >     Please find additional instructions for the source tarball and the
 263      individual platform dependent binary packages below.
 264     </P
 265 ><DIV
 266 CLASS="SECT3"
 267 ><H3
 268 CLASS="SECT3"
 269 ><A
 270 NAME="NEWRELEASE-TARBALL"
 271 >8.2.1. Source Tarball</A
 272 ></H3
 273 ><P
 274 >       First, <I
 275 CLASS="EMPHASIS"
 276 >make sure that you have freshly exported the right
 277         version into an empty directory</I
 278 >. (See "Building and releasing
 279         packages" above). Then run:
 280         </P
 281 ><P
 282 >       <TABLE
 283 BORDER="0"
 284 BGCOLOR="#E0E0E0"
 285 WIDTH="100%"
 286 ><TR
 287 ><TD
 288 ><PRE
 289 CLASS="PROGRAMLISTING"
 290 >  cd current
 291   autoheader &#38;&#38; autoconf &#38;&#38; ./configure
 292         </PRE
 293 ></TD
 294 ></TR
 295 ></TABLE
 296 >
 297         </P
 298 ><P
 299 >       Then do:
 300         </P
 301 ><P
 302 >       <TABLE
 303 BORDER="0"
 304 BGCOLOR="#E0E0E0"
 305 WIDTH="100%"
 306 ><TR
 307 ><TD
 308 ><PRE
 309 CLASS="PROGRAMLISTING"
 310 >  make tarball-dist
 311         </PRE
 312 ></TD
 313 ></TR
 314 ></TABLE
 315 >
 316         </P
 317 ><P
 318 >       To upload the package to Sourceforge, simply issue
 319         </P
 320 ><P
 321 >       <TABLE
 322 BORDER="0"
 323 BGCOLOR="#E0E0E0"
 324 WIDTH="100%"
 325 ><TR
 326 ><TD
 327 ><PRE
 328 CLASS="PROGRAMLISTING"
 329 >  make tarball-upload
 330         </PRE
 331 ></TD
 332 ></TR
 333 ></TABLE
 334 >
 335         </P
 336 ><P
 337 >       Go to the displayed URL and release the file publicly on Sourceforge.
 338         For the change log field, use the relevant section of the
 339         <TT
 340 CLASS="FILENAME"
 341 >ChangeLog</TT
 342 > file.
 343       </P
 344 ></DIV
 345 ><DIV
 346 CLASS="SECT3"
 347 ><H3
 348 CLASS="SECT3"
 349 ><A
 350 NAME="NEWRELEASE-RPM"
 351 >8.2.2. SuSE or Red Hat</A
 352 ></H3
 353 ><P
 354 >       First, <I
 355 CLASS="EMPHASIS"
 356 >make sure that you have freshly exported the right
 357         version into an empty directory</I
 358 >. (See "Building and releasing
 359         packages" above). Then run:
 360         </P
 361 ><P
 362 >       <TABLE
 363 BORDER="0"
 364 BGCOLOR="#E0E0E0"
 365 WIDTH="100%"
 366 ><TR
 367 ><TD
 368 ><PRE
 369 CLASS="PROGRAMLISTING"
 370 >  cd current
 371   autoheader &#38;&#38; autoconf &#38;&#38; ./configure
 372         </PRE
 373 ></TD
 374 ></TR
 375 ></TABLE
 376 >
 377         </P
 378 ><P
 379 >       Then do
 380         </P
 381 ><P
 382 >       <TABLE
 383 BORDER="0"
 384 BGCOLOR="#E0E0E0"
 385 WIDTH="100%"
 386 ><TR
 387 ><TD
 388 ><PRE
 389 CLASS="PROGRAMLISTING"
 390 >  make suse-dist (or make redhat-dist)
 391         </PRE
 392 ></TD
 393 ></TR
 394 ></TABLE
 395 >
 396         </P
 397 ><P
 398 >       To upload the package to Sourceforge, simply issue
 399         </P
 400 ><P
 401 >       <TABLE
 402 BORDER="0"
 403 BGCOLOR="#E0E0E0"
 404 WIDTH="100%"
 405 ><TR
 406 ><TD
 407 ><PRE
 408 CLASS="PROGRAMLISTING"
 409 >  make suse-upload (or make redhat-upload)
 410         </PRE
 411 ></TD
 412 ></TR
 413 ></TABLE
 414 >
 415         </P
 416 ><P
 417 >       Go to the displayed URL and release the file publicly on Sourceforge.
 418         Use the release notes and çhange log from the source tarball package.
 419       </P
 420 ></DIV
 421 ><DIV
 422 CLASS="SECT3"
 423 ><H3
 424 CLASS="SECT3"
 425 ><A
 426 NAME="NEWRELEASE-OS2"
 427 >8.2.3. OS/2</A
 428 ></H3
 429 ><P
 430 >       First, <I
 431 CLASS="EMPHASIS"
 432 >make sure that you have freshly exported the right
 433         version into an empty directory</I
 434 >. (See "Building and releasing
 435         packages" above). Then get the OS/2 Setup module:
 436         </P
 437 ><P
 438 >       <TABLE
 439 BORDER="0"
 440 BGCOLOR="#E0E0E0"
 441 WIDTH="100%"
 442 ><TR
 443 ><TD
 444 ><PRE
 445 CLASS="PROGRAMLISTING"
 446 >  cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa co os2setup
 447         </PRE
 448 ></TD
 449 ></TR
 450 ></TABLE
 451 >
 452         </P
 453 ><P
 454 >       You will need a mix of development tools.
 455         The main compilation takes place with IBM Visual Age C++.
 456         Some ancillary work takes place with GNU tools, available from
 457         various sources like hobbes.nmsu.edu.
 458         Specificially, you will need <TT
 459 CLASS="FILENAME"
 460 >autoheader</TT
 461 >,
 462         <TT
 463 CLASS="FILENAME"
 464 >autoconf</TT
 465 > and <TT
 466 CLASS="FILENAME"
 467 >sh</TT
 468 > tools.
 469         The packaging takes place with WarpIN, available from various sources, including
 470         its home page: <A
 471 HREF="http://www.xworkplace.org/"
 472 TARGET="_top"
 473 >xworkplace</A
 474 >.
 475         </P
 476 ><P
 477 >       Change directory to the <TT
 478 CLASS="FILENAME"
 479 >os2setup</TT
 480 > directory.
 481         Edit the os2build.cmd file to set the final executable filename.
 482         For example,
 483         </P
 484 ><P
 485 >       <TABLE
 486 BORDER="0"
 487 BGCOLOR="#E0E0E0"
 488 WIDTH="100%"
 489 ><TR
 490 ><TD
 491 ><PRE
 492 CLASS="PROGRAMLISTING"
 493 >  installExeName='privoxyos2_setup_X.Y.Z.exe'
 494         </PRE
 495 ></TD
 496 ></TR
 497 ></TABLE
 498 >
 499         </P
 500 ><P
 501 >       Next, edit the <TT
 502 CLASS="FILENAME"
 503 >IJB.wis</TT
 504 > file so the release number matches
 505         in the <TT
 506 CLASS="FILENAME"
 507 >PACKAGEID</TT
 508 > section:
 509         </P
 510 ><P
 511 >       <TABLE
 512 BORDER="0"
 513 BGCOLOR="#E0E0E0"
 514 WIDTH="100%"
 515 ><TR
 516 ><TD
 517 ><PRE
 518 CLASS="PROGRAMLISTING"
 519 >  PACKAGEID="Privoxy Team\Privoxy\Privoxy Package\X\Y\Z"
 520         </PRE
 521 ></TD
 522 ></TR
 523 ></TABLE
 524 >
 525         </P
 526 ><P
 527 >       You're now ready to build.  Run:
 528         </P
 529 ><P
 530 >       <TABLE
 531 BORDER="0"
 532 BGCOLOR="#E0E0E0"
 533 WIDTH="100%"
 534 ><TR
 535 ><TD
 536 ><PRE
 537 CLASS="PROGRAMLISTING"
 538 >  os2build
 539         </PRE
 540 ></TD
 541 ></TR
 542 ></TABLE
 543 >
 544         </P
 545 ><P
 546 >         You will find the  WarpIN-installable executable in the
 547         <TT
 548 CLASS="FILENAME"
 549 >./files</TT
 550 > directory. Upload this anonymously to
 551          <TT
 552 CLASS="FILENAME"
 553 >uploads.sourceforge.net/incoming</TT
 554 >, create a release
 555          for it, and you're done. Use the release notes and Change Log from the
 556          source tarball package.
 557         </P
 558 ></DIV
 559 ><DIV
 560 CLASS="SECT3"
 561 ><H3
 562 CLASS="SECT3"
 563 ><A
 564 NAME="NEWRELEASE-SOLARIS"
 565 >8.2.4. Solaris</A
 566 ></H3
 567 ><P
 568 >       Login to Sourceforge's compilefarm via ssh:
 569         </P
 570 ><P
 571 >       <TABLE
 572 BORDER="0"
 573 BGCOLOR="#E0E0E0"
 574 WIDTH="100%"
 575 ><TR
 576 ><TD
 577 ><PRE
 578 CLASS="PROGRAMLISTING"
 579 >  ssh cf.sourceforge.net
 580         </PRE
 581 ></TD
 582 ></TR
 583 ></TABLE
 584 >
 585         </P
 586 ><P
 587 >       Choose the right operating system (not the Debian one).
 588         When logged in, <I
 589 CLASS="EMPHASIS"
 590 >make sure that you have freshly exported the right
 591         version into an empty directory</I
 592 >. (See "Building and releasing
 593         packages" above). Then run:
 594         </P
 595 ><P
 596 >       <TABLE
 597 BORDER="0"
 598 BGCOLOR="#E0E0E0"
 599 WIDTH="100%"
 600 ><TR
 601 ><TD
 602 ><PRE
 603 CLASS="PROGRAMLISTING"
 604 >  cd current
 605   autoheader &#38;&#38; autoconf &#38;&#38; ./configure
 606         </PRE
 607 ></TD
 608 ></TR
 609 ></TABLE
 610 >
 611         </P
 612 ><P
 613 >       Then run
 614         </P
 615 ><P
 616 >       <TABLE
 617 BORDER="0"
 618 BGCOLOR="#E0E0E0"
 619 WIDTH="100%"
 620 ><TR
 621 ><TD
 622 ><PRE
 623 CLASS="PROGRAMLISTING"
 624 >  gmake solaris-dist
 625         </PRE
 626 ></TD
 627 ></TR
 628 ></TABLE
 629 >
 630         </P
 631 ><P
 632 >       which creates a gzip'ed tar archive. Sadly, you cannot use <B
 633 CLASS="COMMAND"
 634 >make
 635         solaris-upload</B
 636 > on the Sourceforge machine (no ncftpput). You now have
 637         to manually upload the archive to Sourceforge's ftp server and release
 638         the file publicly. Use the release notes and Change Log from the
 639         source tarball package.
 640         </P
 641 ></DIV
 642 ><DIV
 643 CLASS="SECT3"
 644 ><H3
 645 CLASS="SECT3"
 646 ><A
 647 NAME="NEWRELEASE-WINDOWS"
 648 >8.2.5. Windows</A
 649 ></H3
 650 ><P
 651 >        You should ensure you have the latest version of Cygwin (from
 652         <A
 653 HREF="http://www.cygwin.com/"
 654 TARGET="_top"
 655 >http://www.cygwin.com/</A
 656 >).
 657         Run the following commands from within a Cygwin bash shell.
 658       </P
 659 ><P
 660 >       First, <I
 661 CLASS="EMPHASIS"
 662 >make sure that you have freshly exported the right
 663         version into an empty directory</I
 664 >. (See "Building and releasing
 665         packages" above). Then get the Windows setup module:
 666       </P
 667 ><P
 668 >      <TABLE
 669 BORDER="0"
 670 BGCOLOR="#E0E0E0"
 671 WIDTH="100%"
 672 ><TR
 673 ><TD
 674 ><PRE
 675 CLASS="PROGRAMLISTING"
 676 >        cvs -z3  -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa co winsetup
 677       </PRE
 678 ></TD
 679 ></TR
 680 ></TABLE
 681 >
 682       </P
 683 ><P
 684 >        Then you can build the package.  This is fully automated, and is
 685         controlled by <TT
 686 CLASS="FILENAME"
 687 >winsetup/GNUmakefile</TT
 688 >.
 689         All you need to do is:
 690       </P
 691 ><P
 692 >      <TABLE
 693 BORDER="0"
 694 BGCOLOR="#E0E0E0"
 695 WIDTH="100%"
 696 ><TR
 697 ><TD
 698 ><PRE
 699 CLASS="PROGRAMLISTING"
 700 >        cd winsetup
 701         make
 702       </PRE
 703 ></TD
 704 ></TR
 705 ></TABLE
 706 >
 707       </P
 708 ><P
 709 >        Now you can manually rename <TT
 710 CLASS="FILENAME"
 711 >privoxy_setup.exe</TT
 712 > to
 713         <TT
 714 CLASS="FILENAME"
 715 >privoxy_setup_X_Y_Z.exe</TT
 716 >, and upload it to
 717         SourceForge. When releasing the package on SourceForge, use the release notes
 718         and Change Log from the source tarball package.
 719       </P
 720 ></DIV
 721 ><DIV
 722 CLASS="SECT3"
 723 ><H3
 724 CLASS="SECT3"
 725 ><A
 726 NAME="NEWRELEASE-DEBIAN"
 727 >8.2.6. Debian</A
 728 ></H3
 729 ><P
 730 >       First, <I
 731 CLASS="EMPHASIS"
 732 >make sure that you have freshly exported the right
 733         version into an empty directory</I
 734 >. (See "Building and releasing
 735         packages" above). Then, run:
 736         </P
 737 ><P
 738 >       <TABLE
 739 BORDER="0"
 740 BGCOLOR="#E0E0E0"
 741 WIDTH="100%"
 742 ><TR
 743 ><TD
 744 ><PRE
 745 CLASS="PROGRAMLISTING"
 746 >  cd current
 747   autoheader &#38;&#38; autoconf &#38;&#38; ./configure
 748         </PRE
 749 ></TD
 750 ></TR
 751 ></TABLE
 752 >
 753         </P
 754 ><P
 755 >       Then do FIXME.
 756         </P
 757 ></DIV
 758 ><DIV
 759 CLASS="SECT3"
 760 ><H3
 761 CLASS="SECT3"
 762 ><A
 763 NAME="NEWRELEASE-MACOSX"
 764 >8.2.7. Mac OSX</A
 765 ></H3
 766 ><P
 767 >       First, <I
 768 CLASS="EMPHASIS"
 769 >make sure that you have freshly exported the right
 770         version into an empty directory</I
 771 >. (See "Building and releasing
 772         packages" above). Then get the Mac OSX setup module:
 773         </P
 774 ><P
 775 >       <TABLE
 776 BORDER="0"
 777 BGCOLOR="#E0E0E0"
 778 WIDTH="100%"
 779 ><TR
 780 ><TD
 781 ><PRE
 782 CLASS="PROGRAMLISTING"
 783 >  cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa co osxsetup
 784         </PRE
 785 ></TD
 786 ></TR
 787 ></TABLE
 788 >
 789         </P
 790 ><P
 791 >       Then run:
 792         </P
 793 ><P
 794 >       <TABLE
 795 BORDER="0"
 796 BGCOLOR="#E0E0E0"
 797 WIDTH="100%"
 798 ><TR
 799 ><TD
 800 ><PRE
 801 CLASS="PROGRAMLISTING"
 802 >  cd osxsetup
 803   build
 804         </PRE
 805 ></TD
 806 ></TR
 807 ></TABLE
 808 >
 809         </P
 810 ><P
 811 >       This will run <TT
 812 CLASS="FILENAME"
 813 >autoheader</TT
 814 >, <TT
 815 CLASS="FILENAME"
 816 >autoconf</TT
 817 > and
 818         <TT
 819 CLASS="FILENAME"
 820 >configure</TT
 821 > as well as <TT
 822 CLASS="FILENAME"
 823 >make</TT
 824 >.
 825         Finally, it will copy over the necessary files to the ./osxsetup/files directory
 826         for further processing by <TT
 827 CLASS="FILENAME"
 828 >PackageMaker</TT
 829 >.
 830         </P
 831 ><P
 832 >       Bring up PackageMaker with the PrivoxyPackage.pmsp definition file, modify the package
 833         name to match the release, and hit the "Create package" button.
 834         If you specify ./Privoxy.pkg as the output package name, you can then create
 835         the distributable zip file with the command:
 836         </P
 837 ><P
 838 >       <TABLE
 839 BORDER="0"
 840 BGCOLOR="#E0E0E0"
 841 WIDTH="100%"
 842 ><TR
 843 ><TD
 844 ><PRE
 845 CLASS="PROGRAMLISTING"
 846 >zip -r privoxyosx_setup_x.y.z.zip Privoxy.pkg
 847         </PRE
 848 ></TD
 849 ></TR
 850 ></TABLE
 851 >
 852         </P
 853 ><P
 854 >       You can then upload <TT
 855 CLASS="FILENAME"
 856 >privoxyosx_setup_x.y.z.zip</TT
 857 > anonymously to
 858         <TT
 859 CLASS="FILENAME"
 860 >uploads.sourceforge.net/incoming</TT
 861 >,
 862         create a release for it, and you're done. Use the release notes
 863         and Change Log from the source tarball package.
 864         </P
 865 ></DIV
 866 ><DIV
 867 CLASS="SECT3"
 868 ><H3
 869 CLASS="SECT3"
 870 ><A
 871 NAME="NEWRELEASE-FREEBSD"
 872 >8.2.8. FreeBSD</A
 873 ></H3
 874 ><P
 875 >       Login to Sourceforge's compilefarm via ssh:
 876         </P
 877 ><P
 878 >       <TABLE
 879 BORDER="0"
 880 BGCOLOR="#E0E0E0"
 881 WIDTH="100%"
 882 ><TR
 883 ><TD
 884 ><PRE
 885 CLASS="PROGRAMLISTING"
 886 >  ssh cf.sourceforge.net
 887         </PRE
 888 ></TD
 889 ></TR
 890 ></TABLE
 891 >
 892         </P
 893 ><P
 894 >       Choose the right operating system.
 895         When logged in, <I
 896 CLASS="EMPHASIS"
 897 >make sure that you have freshly exported the right
 898         version into an empty directory</I
 899 >. (See "Building and releasing
 900         packages" above). Then run:
 901         </P
 902 ><P
 903 >       <TABLE
 904 BORDER="0"
 905 BGCOLOR="#E0E0E0"
 906 WIDTH="100%"
 907 ><TR
 908 ><TD
 909 ><PRE
 910 CLASS="PROGRAMLISTING"
 911 >  cd current
 912   autoheader &#38;&#38; autoconf &#38;&#38; ./configure
 913         </PRE
 914 ></TD
 915 ></TR
 916 ></TABLE
 917 >
 918         </P
 919 ><P
 920 >       Then run:
 921         </P
 922 ><P
 923 >       <TABLE
 924 BORDER="0"
 925 BGCOLOR="#E0E0E0"
 926 WIDTH="100%"
 927 ><TR
 928 ><TD
 929 ><PRE
 930 CLASS="PROGRAMLISTING"
 931 >  gmake freebsd-dist
 932         </PRE
 933 ></TD
 934 ></TR
 935 ></TABLE
 936 >
 937         </P
 938 ><P
 939 >       which creates a gzip'ed tar archive. Sadly, you cannot use <B
 940 CLASS="COMMAND"
 941 >make
 942         freebsd-upload</B
 943 > on the Sourceforge machine (no ncftpput). You now have
 944         to manually upload the archive to Sourceforge's ftp server and release
 945         the file publicly. Use the release notes and Change Log from the
 946         source tarball package.
 947         </P
 948 ></DIV
 949 ><DIV
 950 CLASS="SECT3"
 951 ><H3
 952 CLASS="SECT3"
 953 ><A
 954 NAME="NEWRELEASE-HPUX"
 955 >8.2.9. HP-UX 11</A
 956 ></H3
 957 ><P
 958 >       First, <I
 959 CLASS="EMPHASIS"
 960 >make sure that you have freshly exported the right
 961         version into an empty directory</I
 962 >. (See "Building and releasing
 963         packages" above). Then run:
 964         </P
 965 ><P
 966 >       <TABLE
 967 BORDER="0"
 968 BGCOLOR="#E0E0E0"
 969 WIDTH="100%"
 970 ><TR
 971 ><TD
 972 ><PRE
 973 CLASS="PROGRAMLISTING"
 974 >  cd current
 975   autoheader &#38;&#38; autoconf &#38;&#38; ./configure
 976         </PRE
 977 ></TD
 978 ></TR
 979 ></TABLE
 980 >
 981         </P
 982 ><P
 983 >       Then do FIXME.
 984         </P
 985 ></DIV
 986 ><DIV
 987 CLASS="SECT3"
 988 ><H3
 989 CLASS="SECT3"
 990 ><A
 991 NAME="NEWRELEASE-AMIGA"
 992 >8.2.10. Amiga OS</A
 993 ></H3
 994 ><P
 995 >       First, <I
 996 CLASS="EMPHASIS"
 997 >make sure that you have freshly exported the right
 998         version into an empty directory</I
 999 >. (See "Building and releasing
1000         packages" above). Then run:
1001         </P
1002 ><P
1003 >       <TABLE
1004 BORDER="0"
1005 BGCOLOR="#E0E0E0"
1006 WIDTH="100%"
1007 ><TR
1008 ><TD
1009 ><PRE
1010 CLASS="PROGRAMLISTING"
1011 >  cd current
1012   autoheader &#38;&#38; autoconf &#38;&#38; ./configure
1013         </PRE
1014 ></TD
1015 ></TR
1016 ></TABLE
1017 >
1018         </P
1019 ><P
1020 >       Then do FIXME.
1021         </P
1022 ></DIV
1023 ><DIV
1024 CLASS="SECT3"
1025 ><H3
1026 CLASS="SECT3"
1027 ><A
1028 NAME="NEWRELEASE-AIX"
1029 >8.2.11. AIX</A
1030 ></H3
1031 ><P
1032 >       Login to Sourceforge's compilefarm via ssh:
1033         </P
1034 ><P
1035 >       <TABLE
1036 BORDER="0"
1037 BGCOLOR="#E0E0E0"
1038 WIDTH="100%"
1039 ><TR
1040 ><TD
1041 ><PRE
1042 CLASS="PROGRAMLISTING"
1043 >  ssh cf.sourceforge.net
1044         </PRE
1045 ></TD
1046 ></TR
1047 ></TABLE
1048 >
1049         </P
1050 ><P
1051 >       Choose the right operating system.
1052         When logged in, <I
1053 CLASS="EMPHASIS"
1054 >make sure that you have freshly exported the right
1055         version into an empty directory</I
1056 >. (See "Building and releasing
1057         packages" above). Then run:
1058         </P
1059 ><P
1060 >       <TABLE
1061 BORDER="0"
1062 BGCOLOR="#E0E0E0"
1063 WIDTH="100%"
1064 ><TR
1065 ><TD
1066 ><PRE
1067 CLASS="PROGRAMLISTING"
1068 >  cd current
1069   autoheader &#38;&#38; autoconf &#38;&#38; ./configure
1070         </PRE
1071 ></TD
1072 ></TR
1073 ></TABLE
1074 >
1075         </P
1076 ><P
1077 >       Then run:
1078         </P
1079 ><P
1080 >       <TABLE
1081 BORDER="0"
1082 BGCOLOR="#E0E0E0"
1083 WIDTH="100%"
1084 ><TR
1085 ><TD
1086 ><PRE
1087 CLASS="PROGRAMLISTING"
1088 >  make aix-dist
1089         </PRE
1090 ></TD
1091 ></TR
1092 ></TABLE
1093 >
1094         </P
1095 ><P
1096 >       which creates a gzip'ed tar archive. Sadly, you cannot use <B
1097 CLASS="COMMAND"
1098 >make
1099         aix-upload</B
1100 > on the Sourceforge machine (no ncftpput). You now have
1101         to manually upload the archive to Sourceforge's ftp server and release
1102         the file publicly. Use the release notes and Change Log from the
1103         source tarball package.
1104         </P
1105 ></DIV
1106 ></DIV
1107 ><DIV
1108 CLASS="SECT2"
1109 ><H2
1110 CLASS="SECT2"
1111 ><A
1112 NAME="AFTERRELEASE"
1113 >8.3. After the Release</A
1114 ></H2
1115 ><P
1116 >      When all (or: most of the) packages have been uploaded and made available,
1117       send an email to the <A
1118 HREF="mailto:ijbswa-announce@lists.sourceforge.net"
1119 TARGET="_top"
1120 >announce
1121       mailing list</A
1122 >, Subject: "Version X.Y.Z available for download". Be sure to
1123       include the
1124       <A
1125 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
1126 TARGET="_top"
1127 >download
1128       location</A
1129 >, the release notes and the change log.
1130      </P
1131 ></DIV
1132 ></DIV
1133 ><DIV
1134 CLASS="NAVFOOTER"
1135 ><HR
1136 ALIGN="LEFT"
1137 WIDTH="100%"><TABLE
1138 WIDTH="100%"
1139 BORDER="0"
1140 CELLPADDING="0"
1141 CELLSPACING="0"
1142 ><TR
1143 ><TD
1144 WIDTH="33%"
1145 ALIGN="left"
1146 VALIGN="top"
1147 ><A
1148 HREF="testing.html"
1149 >Prev</A
1150 ></TD
1151 ><TD
1152 WIDTH="34%"
1153 ALIGN="center"
1154 VALIGN="top"
1155 ><A
1156 HREF="index.html"
1157 >Home</A
1158 ></TD
1159 ><TD
1160 WIDTH="33%"
1161 ALIGN="right"
1162 VALIGN="top"
1163 ><A
1164 HREF="webserver-update.html"
1165 >Next</A
1166 ></TD
1167 ></TR
1168 ><TR
1169 ><TD
1170 WIDTH="33%"
1171 ALIGN="left"
1172 VALIGN="top"
1173 >Testing Guidelines</TD
1174 ><TD
1175 WIDTH="34%"
1176 ALIGN="center"
1177 VALIGN="top"
1178 >&nbsp;</TD
1179 ><TD
1180 WIDTH="33%"
1181 ALIGN="right"
1182 VALIGN="top"
1183 >Update the Webserver</TD
1184 ></TR
1185 ></TABLE
1186 ></DIV
1187 ></BODY
1188 ></HTML
1189 >