Flavio Poletti writes: > > > 2. If you agree that "perldoc -f qw" should return some actual > > > content about the qw function, > > > > I think it's fine. It's not a function, it's an operator. > > Then this should go out of the "scope" of perldoc -f.
Yes. It pretty much is. > Either it should remain in, so it would be better to give immediate > help without hunting, or it should go out because it's an operator and > not a function. But if it went, people who don't know that it's an operator would do perldoc -f qw and get the 'No documentation' message, which doesn't help them. So it makes sense to be more helpful than that by pointing out that it's an operator and telling them where they _can_ read about it. > The hybrid way seems confusing to me. If we don't have cross references in the documentation then either everything is only mentioned in one place (and you have to know exactly where to look), or text is copied into lots of places, making the documentation much bigger (and harder to maintain). I don't see why somebody who's capable of programming Perl would have trouble with the concept of cross references in documentation. Smylers
