From e200d3e7c7ef20b29a47b67e58b7561f4099e7ae Mon Sep 17 00:00:00 2001 From: Kurt Date: Thu, 1 Nov 2018 11:51:50 -0400 Subject: Explain in documentation why CreateTemplate() is deprecated. --- template.go | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) (limited to 'template.go') diff --git a/template.go b/template.go index 0c86762..0bb7f75 100644 --- a/template.go +++ b/template.go @@ -31,7 +31,13 @@ func (f *Fpdf) CreateTemplateCustom(corner PointType, size SizeType, fn func(*Tp return newTpl(corner, size, f.defOrientation, f.unitStr, f.fontDirStr, fn, f) } -// CreateTemplate creates a template not attached to any document (deprecated) +// CreateTemplate creates a template that is not attached to any document. +// +// This function is deprecated; it incorrectly assumes that a page with a width +// smaller than its height is oriented in portrait mode, otherwise it assumes +// landscape mode. This causes problems when placing the template in a master +// document where this condition does not apply. CreateTpl() is a similar +// function that lets you specify the orientation to avoid this problem. func CreateTemplate(corner PointType, size SizeType, unitStr, fontDirStr string, fn func(*Tpl)) Template { orientationStr := "p" if size.Wd > size.Ht { @@ -41,7 +47,7 @@ func CreateTemplate(corner PointType, size SizeType, unitStr, fontDirStr string, return CreateTpl(corner, size, orientationStr, unitStr, fontDirStr, fn) } -// CreateTemplate creates a template not attached to any document +// CreateTpl creates a template not attached to any document func CreateTpl(corner PointType, size SizeType, orientationStr, unitStr, fontDirStr string, fn func(*Tpl)) Template { return newTpl(corner, size, orientationStr, unitStr, fontDirStr, fn, nil) } -- cgit v1.2.1-24-ge1ad