Opened 16 years ago

Last modified 10 years ago

#15625 new enhancement

Guide doesn't explain variants very well

Reported by: myrrhlin@… Owned by: macports-tickets@…
Priority: Normal Milestone:
Component: guide Version:
Keywords: Cc: nerdling (Jeremy Lavergne), cooljeanius (Eric Gallager)
Port:

Description

There are some obvious questions about variants which are not answered in the guide (and also not in the FAQ). I only began to figure out the answers by trying things and finding out what worked and what didn't. The guide should be expanded to answer these questions.

  • Can multiple variant options be selected at install time? (yes)
  • Do variant options sometimes conflict, and how would I know? (??)
  • Can two variants be installed at the same time? (yes, but only one can be active at a given time. use port deactivate on the first variant, then install the second)
  • Can an existing variant be modified to add or remove variant options? (no)
  • What if I need to add a new option to a variant (or remove one)? (uninstall it, then reinstall with the desired options)
  • Is the 'universal' variant considered to be exclusive of all other options? That is, if there is an option that enables liba52 support, am I to assume the universal install doesn't have this support? (??)
  • The documentation mentions turning off 'default' variant options with the minus sign syntax -- how do I find out which are the default ones, if any (other than reading the portfile)? (??)

I might add that the short descriptions of the variants are quite unclear to me, and insufficient. They're the sort of description which are adequate if you already know what the options mean. If you don't, it doesn't help much in making wise choices. I hope you consider support for greater documentation of these choices in the portfiles or elsewhere, more than a fraction of a line. The wiki would also be a great place for further documentation of this kind, if it was expanded to include pages for every port with variants. Please make it easier somehow for the documentation of variants to be expanded.

Here's an example. Whats the difference between darwin7, darwin8, macosx options as opposed to universal? I know 10.4 is darwin 8 (you should explain that too), but just when do I need to specify that? Anytime I see it given as a variant? Are darwin7 and darwin8 exclusive? Are darwin8 and macosx exclusive? How would I know?

Another example. I see that ffmpeg includes native support for vorbis and xvid, but there are variant options to use external libraries instead. What are the advantages to each choice? Which provides greater speed/flexibility/etc?

Attachments (1)

patch-guide-variants.diff (1.8 KB) - added by nerdling (Jeremy Lavergne) 14 years ago.

Download all attachments as: .zip

Change History (7)

comment:1 Changed 16 years ago by raimue (Rainer Müller)

I opened #15628 as a spinoff of this issue. Some of these things here should be displayed by port variants.

comment:2 Changed 16 years ago by jmroot (Joshua Root)

Milestone: Website & Documentation

comment:3 Changed 15 years ago by (none)

Milestone: Website & Documentation

Milestone Website & Documentation deleted

Changed 14 years ago by nerdling (Jeremy Lavergne)

Attachment: patch-guide-variants.diff added

comment:4 Changed 14 years ago by nerdling (Jeremy Lavergne)

Cc: snc@… added

Cc Me!

comment:5 Changed 11 years ago by cooljeanius (Eric Gallager)

Cc: egall@… added

Cc Me!

comment:6 Changed 10 years ago by mf2k (Frank Schima)

Keywords: doc variants guide wiki removed
Owner: changed from markd@… to macports-tickets@…
Type: defectenhancement
Version: 1.6.0

markd has retired. See #44782.

Note: See TracTickets for help on using tickets.