README.MAKEFILE 3.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101
  1. Description of makefile rules
  2. =============================
  3. release
  4. -------
  5. Build Tor Browser for the release channel, for all supported platforms.
  6. The resulting build can be found in directory release/$version.
  7. release-{linux-x86_64,linux-i686,windows-i686,osx-x86_64}
  8. ---------------------------------------------------------
  9. Same as release, for the selected platform only.
  10. alpha
  11. -----
  12. Build Tor Browser for the alpha channel, for all supported platforms.
  13. The resulting build can be found in directory alpha/$version.
  14. alpha-{linux-x86_64,linux-i686,windows-i686,osx-x86_64}
  15. -------------------------------------------------------
  16. Same as alpha, for the selected platform only.
  17. nightly
  18. -------
  19. Build Tor Browser for the nightly channel, for all supported platforms.
  20. Many of the components will be based on the master branch. You might
  21. want to run "make fetch" before, to fetch the latest commits from all
  22. components.
  23. The resulting build can be found in directory nightly/$date
  24. nightly-{linux-x86_64,linux-i686,windows-i686,osx-x86_64}
  25. ---------------------------------------------------------
  26. Same as nightly, for the selected platform only.
  27. alpha_nightly
  28. -------------
  29. Build Tor Browser for the alpha channel, for all supported platforms.
  30. This is the same as 'make alpha', but the output directory is different.
  31. The resulting build can be found in directory alpha_nightly/$date
  32. alpha_nightly-{linux-x86_64,linux-i686,windows-i686,osx-x86_64}
  33. ---------------------------------------------------------------
  34. The same as alpha_nightly, for the selected platform only.
  35. testbuild
  36. ---------
  37. Build a Tor Browser test build. To make the build faster, only the en-US
  38. locale is created, without mar files. By default it is based on the
  39. alpha channel, but you can change that by editing rbm.conf.local.
  40. The resulting build can be found in directory testbuild.
  41. {release,alpha,nightly,testbuild}-linux-x86_64-debug
  42. ----------------------------------------------------
  43. Create a debug build for Linux x86_64 with debug features such as ASan.
  44. fetch
  45. -----
  46. Fetch new commits from all components. This is useful when you want to
  47. build the nightly channel.
  48. clean
  49. -----
  50. Clean files created during previous builds that are no longer used in
  51. current builds. Before using this command, you first need to configure
  52. in rbm.local.conf the channel(s) that you are building.
  53. In other software, the clean rule is used to remove all build files,
  54. but this is not the case here, where only obsolete build files are
  55. removed. It is usually not necessary to remove all build files before
  56. starting a new build as the need for rebuilding components is detected
  57. automatically. If you want to remove all build files, you can remove
  58. the out/ directory.
  59. clean-dry-run
  60. -------------
  61. Print the files that would be removed when running 'make clean'.
  62. signtag-{release,alpha}
  63. -----------------------
  64. Create a git signed tag for the selected channel, using the version and
  65. build number defined as var/torbrowser_version and var/torbrowser_build.
  66. incrementals-{release,alpha}
  67. ----------------------------
  68. Create incremental mar files for an unsigned build in the release or
  69. alpha channel.
  70. dmg2mar-{release,alpha)
  71. -----------------------
  72. Generate updated mar files for the OSX bundles, from the dmg files, then
  73. regenerate the OSX incremental mar files. You should run this after
  74. signing the OSX dmg files.
  75. update_responses-{release,alpha}
  76. --------------------------------
  77. Create update responses xml files for a signed build in the release or
  78. alpha channel. The files can be found in a tar in the directory
  79. {release,alpha}/update-responses.